diff options
Diffstat (limited to 'Master/texmf-dist/doc/texlive/texlive-pl')
-rw-r--r-- | Master/texmf-dist/doc/texlive/texlive-pl/Makefile | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/texlive/texlive-pl/live4ht.cfg | 52 | ||||
-rw-r--r-- | Master/texmf-dist/doc/texlive/texlive-pl/tex-live.css | 44 | ||||
-rw-r--r-- | Master/texmf-dist/doc/texlive/texlive-pl/tex-livep.sty | 497 | ||||
-rw-r--r-- | Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.css | 380 | ||||
-rw-r--r-- | Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.html | 6942 | ||||
-rw-r--r-- | Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.pdf | bin | 0 -> 965707 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.tex | 3862 |
8 files changed, 11779 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/texlive/texlive-pl/Makefile b/Master/texmf-dist/doc/texlive/texlive-pl/Makefile new file mode 100644 index 00000000000..f91a1e554a1 --- /dev/null +++ b/Master/texmf-dist/doc/texlive/texlive-pl/Makefile @@ -0,0 +1,2 @@ +include ../texlive-en/Makefile +doc = texlive-pl diff --git a/Master/texmf-dist/doc/texlive/texlive-pl/live4ht.cfg b/Master/texmf-dist/doc/texlive/texlive-pl/live4ht.cfg new file mode 100644 index 00000000000..508794f6918 --- /dev/null +++ b/Master/texmf-dist/doc/texlive/texlive-pl/live4ht.cfg @@ -0,0 +1,52 @@ +% tex4ht configuration file for the TeX Live documentation. +% Accumulated over many years. Public domain. +% +% html specifies the main output format. +% info for extra debugging info in the log files. + +% have html in one piece (including footnotes). +%\Preamble{charset=iso-8559-2,html,info,fn-in} +\Preamble{html,info,fn-in} + +% add extra stylesheet +\Configure{@HEAD}{\HCode{% +<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]{../texlive-common/\csname Gin@base\endcsname.png}% + } +% or LaTeX complains it is missing. +\begin{document} + +\EndPreamble + +% simplify output for HTML. We leave TeX and LaTeX alone, since tex4ht +% actually does the lowered E (and raised A) in CSS. +%\def\OMEGA{Omega} +\def\LaTeXe{LaTeX2e} +\def\eTeX{e-\TeX} +\def\acro#1{#1} +\def\MF{Metafont} +\def\BibTeX{BibTeX} +\def\warningbox{} +\def\endwarningbox{} + +\Configure{crosslinks}{[}{] + }{następny}{poprzedni}{wstecz} + {początek}{koniec}{spis} + +\ifx\tldocenglish\undefined \else + % these definitions cause "missing } inserted" at \end{tabularx} in + % other langs. don't know why. + % + % don't make these into links, as happens with \path. We only have a few + % special characters that actually occur. + \def\dirname{\texttt\bgroup\catcode`\$=12 \catcode`\_=12 \catcode`\~=12 + \finishliteral} + \def\finishliteral#1{#1\egroup} + \let\filename=\dirname +\fi diff --git a/Master/texmf-dist/doc/texlive/texlive-pl/tex-live.css b/Master/texmf-dist/doc/texlive/texlive-pl/tex-live.css new file mode 100644 index 00000000000..b8aa763a0df --- /dev/null +++ b/Master/texmf-dist/doc/texlive/texlive-pl/tex-live.css @@ -0,0 +1,44 @@ +/* $Id: tex-live.css 3436 2007-01-13 22:34:01Z karl $ + Simple CSS for TeX Live that adds margins and a little color. + original by Bzyl Wlodzimierz, edited by Karl Berry, 2005. + Public domain. */ + +html { + // top left bottom right + margin: 15pt 15pt 15pt 15pt; + background: rgb(255,255,224); +} + +body { + margin: 0 5pt 0 5pt; + padding: 0; + //matw: background: rgb(224,255,224); + // (It looks better to me to have a consistent background --karl) +// fonts in browser are low resolution; +// therefore generated serif are poor quality, +// so they disturb reading (that is my opinion) + font-family: sans-serif; + font-style: normal; +} + +/* (It looks better to me to not vary colors at every level --karl) */ + +h3.sectionHead { + padding: 12pt 10pt 12pt 20pt; + //matw: background: rgb(192,224,255); + background: rgb(224,224,255); + color: rgb(0,0,32); +} + +h4.subsectionHead { + padding: 7pt 10pt 7pt 40pt; + background: rgb(224,224,255); + color: rgb(0,0,32); +} + +h5.subsubsectionHead { + padding: 3pt 10pt 3pt 40pt; + //matw: background: rgb(224,255,255); + background: rgb(224,224,255); + color: rgb(0,0,32); +} diff --git a/Master/texmf-dist/doc/texlive/texlive-pl/tex-livep.sty b/Master/texmf-dist/doc/texlive/texlive-pl/tex-livep.sty new file mode 100644 index 00000000000..4f4f54ea9e5 --- /dev/null +++ b/Master/texmf-dist/doc/texlive/texlive-pl/tex-livep.sty @@ -0,0 +1,497 @@ +% TeX Live documentation style. Written by many people over many years. +% Public domain. +% +\NeedsTeXFormat{LaTeX2e}[1995/12/01] +\ProvidesPackage{tex-livep}[2010/07/10 v1.8 TeX Live documentation style] +% +% colortbl and other packages otherwise make the default be letter, it seems. +\RequirePackage[a4paper,hscale=0.75,lines=60,vmarginratio=10:8]{geometry} +% +\RequirePackage{alltt} +\RequirePackage{array} +\RequirePackage{colortbl} +\RequirePackage{comment} +\RequirePackage{float} +\RequirePackage{graphicx} +\RequirePackage{longtable} +\RequirePackage{shortvrb} +\RequirePackage[normalem]{ulem} +\RequirePackage[obeyspaces]{url} +\RequirePackage{xspace} +% +\RequirePackage{lmodern} +\usepackage{textcomp}% including \textbullet +\usepackage[T1]{fontenc} +%\usepackage[latin1]{inputenc} +% +% 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}\@} +\def\acro#1{\textscale{.9}{#1}\@} +% +\RequirePackage{fancyvrb} +\DefineVerbatimEnvironment{verbatim}{Verbatim}{fontsize=\normalsize} +\DefineVerbatimEnvironment{fverbatim}{Verbatim}{fontsize=\footnotesize} +\DefineVerbatimEnvironment{sverbatim}{Verbatim}{fontsize=\small} +\DefineVerbatimEnvironment{boxedverbatim} + {Verbatim}{fontsize=\footnotesize,frame=single} +\DefineVerbatimEnvironment{Verbatim}{Verbatim}{fontsize=\normalsize} +\def\verbatiminput#1{\VerbatimInput[fontsize=\scriptsize]{#1}} +\def\boxedverbatiminput#1{\VerbatimInput[frame=single,fontsize=\scriptsize]{#1}} +\def\listinginput#1#2{\VerbatimInput[fontsize=\scriptsize,firstnumber=#1,numbers=left]{#2}} +\MakeShortVerb\| +% +% +% Done with packages. +% +% Page layout. +\message{dimens: textwidth=\the\textwidth\space + oddsidemargin=\the\oddsidemargin\space + evensidemargin=\the\evensidemargin\space + textheight=\the\textheight\space + topmargin=\the\topmargin\space + footskip=\the\footskip} +% +% with settings above, and without a4 (hence letter): +% textwidth=424.49744pt oddsidemargin=22.25128pt evensidemargin=22.25128pt +% textheight=622.26999pt topmargin=-20.135pt footskip=-6.135pt +% +% with default a4paper geometry settings (not enough height): +% textwidth=418.25368pt oddsidemargin=17.3571pt evensidemargin=17.3571pt +% textheight=591.5302pt topmargin=-7.86334pt footskip=30.0pt +% +% with geometry settings [a4paper,hscale=0.75,lines=60,vmarginratio=10:8]: +% textwidth=448.1309pt oddsidemargin=2.41849pt evensidemargin=2.41849pt +% textheight=718.0pt topmargin=-38.68848pt footskip=30.0pt +% +%%\advance\textwidth by 1.1in +%%\advance\oddsidemargin by -.55in +%%\advance\evensidemargin by -.55in +%% +%\advance\textheight by 1in +%\advance\topmargin by -.5in +%\advance\footskip by -.5in +\pagestyle{headings} +% +% LaTeX parameters. +\renewcommand{\topfraction}{0.85} +\renewcommand{\floatpagefraction}{0.86} +\renewcommand{\textfraction}{0.1} +\renewcommand{\abovecaptionskip}{4pt} +\renewcommand{\belowcaptionskip}{4pt} +\setcounter{tocdepth}{3} +\setcounter{secnumdepth}{3} +\setcounter{topnumber}{5} +\setcounter{totalnumber}{5} +% +% linebreaking, etc. +\hbadness=4000 +\vbadness=4000 +\emergencystretch=.1\hsize +\relpenalty=500 +% +\def\slash{/\penalty\z@\hskip\z@skip } +% +% various sorts of names +\newcommand*{\pkgname}[1]{\textsf{#1}}% package name +\newcommand*{\optname}[1]{\texttt{#1}}% (package,class) option name +\newcommand*{\cmdname}[1]{\textsf{#1}}% command name +\newcommand*{\colname}[1]{\emph{#1}}% collection name +\newcommand*{\dirname}[1]{\path{#1}}% directory name +\def\filename#1{\path{#1}}% file name +\newcommand*{\envname}[1]{\texttt{#1}}% environment variable name +\newcommand{\code}[1]{\texttt{#1}} +\newcommand{\file}[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}} +% 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. +% (We could simplify/remove this next time, I think.) +\def\CDref#1#2{\texttt{#1}} +% +% \OnCD is currently for any other reference to a file or directory in +% the distribution. PDF readers only open .pdf files, though, so we +% should change this to only use \href for those. Or more likely use +% different macros in the source. +% \OnCD no longer has any use at all, since we don't have unpacked files +% on the DVD and it has never worked when reading the PDF online. +\def\OnCD#1{\path{#1}} +%\def\OnCD#1{\href{../../../../#1}{\path{#1}}} +% +% \href incorrectly appends .pdf to anything without an extension; these +% definitions using \hyper@linkurl do not, but they fail for .pdf +% references -- which are the only ones that work anyway. So this is +% useless, in practice. +%\def\CDref#1#2{\hyper@linkurl{#2}{../../../../#1}} +%\def\OnCD#1{\hyper@linkurl{\path{#1}}{../../../../#1}} + +% GUI menu/button/tab sequence: +\def\guiseq#1{\textsf{#1}} +\def\arw{\unskip$\rightarrow$\ignorespaces} +% +% Special names. +\def\dpi{$\,$dpi\xspace} +\def\bs{{\protect\normalfont\ttfamily\char'134}} +\DeclareRobustCommand{\cs}[1]{{\normalfont\ttfamily\char`\\#1}} +\def\Q#1{\par\vskip6pt\leftline{#1}\par} +\def\hyph{-} +% +% many abbreviations. +\def\AllTeX{(\La\kern-.075em)\kern-.075em\TeX} +%\newcommand{\CS}{$\mathcal{C}\kern-.1667em\lower.5ex% +% \hbox{$\mathcal{S}$}\kern-.075em $} +\def\AFMtoTFM{\cmdname{AFM2TFM}\null} +\def\bv{\emph{Baskerville}} +\let\BV=\bv +\newcommand{\CS}{$\mathcal{C}\kern-.1667em\lower.5ex% + \hbox{$\mathcal{S}$}\kern-.075em $} +\def\Dash{\unskip\nobreak\thinspace---\thinspace\ignorespaces} +\def\dvicopy{\cmdname{dvicopy}} +\def\dvidvi{\cmdname{dvidvi}} +\def\dvips{\cmdname{dvips}} +\def\eTeX{$\varepsilon$-\TeX} +\def\fpTeX{\textrm{fp}\TeX\xspace} +\def\GFtoDVI{\cmdname{GFtoDVI}\null} +\def\GFtoPK{\cmdname{GFtoPK}\null} +\def\GFtype{\cmdname{GFtype}} +\def\GUI{\acro{GUI}\xspace} +\def\KPS{Kpathsea} +% This code % is hacked from its definition of \cs{LaTeX}; it allows +% slants (for example) to propagate into the raised (small) `A': +\newcommand{\La}% + {L\kern-.36em + {\setbox0\hbox{T}% + \vbox to\ht0{\hbox{$\m@th$% + \csname S@\f@size\endcsname + \fontsize\sf@size\z@ + \math@fontsfalse\selectfont + A}% + \vss}% + }} +\def\OMEGA{$\Omega$} +\def\OzMF{OzMF} +\def\OzMP{OzMP} +\def\OzTeX{O\kern-.03em z\kern-.15em\TeX} +\def\OzTeX{O\kern-.03em z\kern-.15em\TeX} +\def\p.{p.\,} +\def\PKtype{\cmdname{PKtype}} +\def\PLtoTF{\cmdname{PLtoTF}\null} +\def\ProTeXt{pro\TeX t} +\def\teTeX{\textrm{te}\TeX\xspace} +\def\TeXLive{\TeX{} Live\xspace} +\def\TFtoPL{\cmdname{TFtoPL}\null} +\def\TK{\TeX\ Collection} +\let\TL=\TeXLive +\def\TypeI{Type~1} +\def\VFtoVP{\cmdname{VFtoVP}\null} +\def\VPtoVF{\cmdname{VPtoVF}\null} +\def\Thanh{H\`an~Th\ifx % get Unicode char in tex4ht's HTML output + \HCode\UnDef\^e\llap{\raise 0.5ex\hbox{\'{}}}\else + \HCode{\string&\#x1EBF;}\fi~Th\`anh} +\def\XEmTeX{\textrm{XEm}\TeX\xspace} +\def\XEmacs{\textrm{XEmacs}\xspace} +\def\XeTeX{Xe\TeX} +\def\Webc{Web2C} +\providecommand*{\CD}{\acro{CD}\xspace} +\providecommand*{\CTAN}{\acro{CTAN}\xspace} +\providecommand*{\DVD}{\texorpdfstring{\acro{DVD}}{DVD}\xspace} +\providecommand*{\ISO}{\texorpdfstring{\acro{ISO}}{ISO}\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*{\USB}{\texorpdfstring{\acro{USB}}{USB}\xspace} +\providecommand*{\dvi}{\acro{DVI}\xspace} +\providecommand*{\web}{\texttt{WEB}\xspace} + +% Include an image. +% #1 - name of image (pictures/#1.jpg, always .jpg please) +% #2 - bb for html +% #3 - width for TeX +% +\def\tlimage#1#2#3{% + \ifnum \Status=2 % html, want relative path in output + \includegraphics[#2]{../../general/texlive-common/pictures/#1.jpg} + \else % not html, handled by TEXINPUTS in Makefile + \includegraphics[width=#3]{pictures/#1.jpg} + \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}% + \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. +% Don't know why \descriptionlabel doesn't. +% +\newenvironment{ttdescription} + {\begin{list}{label must be supplied}{% + \itemsep=0pt % these lists tend to have short descriptions + \parindent=0pt + \let\makelabel=\ttdescriptionlabel}}% + {\end{list}} +\newcommand*\ttdescriptionlabel[1]{\hspace\labelsep + \normalfont\ttfamily #1\hfil} +% +% Likewise, for commands using sans serif. +\newenvironment{cmddescription} + {\begin{list}{label must be supplied}{% + \itemsep=0pt + \let\makelabel=\cmddescriptionlabel}}% + {\end{list}} +\newcommand*\cmddescriptionlabel[1]{\hspace\labelsep + \normalfont\sffamily #1\hfil} + +% General squeezed itemize/enumerate. +\newenvironment{itemize*}% + {\begin{itemize}% + \setlength{\itemsep}{0pt}% + \setlength{\parskip}{0pt}}% + {\end{itemize}} + +\newenvironment{enumerate*}% + {\begin{enumerate}% + \setlength{\itemsep}{0pt}% + \setlength{\parskip}{0pt}}% + {\end{enumerate}} + +\newsavebox{\wbox} +\newenvironment{warningbox} + {\begin{lrbox}{\wbox} + \begin{minipage}{.95\textwidth}} + {\end{minipage}\end{lrbox}\fbox{\usebox{\wbox}}} +% +% lrbox is used as a representation marking. I changed it to +% lrBox in tne source file, to get closer to logical marking +\newsavebox{\mylrbox} +\newenvironment{lrBox} + {\begin{lrbox}{\mylrbox}} + {\end{lrbox}} + + +% emacs-page output setup +% +\ifx \HCode\UnDef + \providecommand{\Status}{0}% running TeX +\else + \providecommand{\Status}{2}% running TeX4ht +\fi +%\typeout{Status is \Status} +% +\newif\ifSingleColumn +% +% By default, we won't be creating hyperlinks. +\def\href#1#2{#2} +\def\hypertarget#1#2{} +\def\email#1{\href{mailto:#1}{\path{#1}}} % \path comes from url +\def\htmlanchor#1{} +% +\definecolor{hypercolor}{rgb}{0.5,0.0,0.5} % purplish external links. +% +% +\ifcase\Status + % \Status = 0 + \typeout{TeX Live documentation in DVI format} + \SingleColumntrue + \newenvironment{multicols}[1]{}{} + \or + % \Status = 1 + \typeout{TeX Live documentation in PDF format} + \RequirePackage[breaklinks, + colorlinks,linkcolor=hypercolor,citecolor=hypercolor, + urlcolor=hypercolor,filecolor=hypercolor, + bookmarksopen, + %pdfstartview={FitBH -320000}, % fails with acrobat7 + hyperindex] + {hyperref} + \SingleColumntrue + \newenvironment{multicols}[1]{}{} + \or + % \Status = 2 + \typeout{TeX Live documentation in HTML format} + \SingleColumntrue + \newenvironment{multicols}[1]{}{} + % read our config file, live4ht.cfg; q.v., for more definitions. + % hyperref load must come after the tex4ht load. + \RequirePackage[live4ht]{tex4ht} + \RequirePackage[tex4ht]{hyperref} \hyperlinkfileprefix{} + % definitions need simplifying for TeX4ht to make relative paths work. + \def\CDref#1#2{\href{../../../../#1}{#2}} + \def\OnCD#1{\href{../../../../#1}{#1}} + \def\htmlanchor#1{\HCode{<a id="#1"></a>}} + \or + % \Status = 3 + \typeout{TeX Live documentation as a Baskerville issue} + \@ifundefined{Fonts}% + {\RequirePackage{ae}}% + {\RequirePackage[T1]{\Fonts}} + \RequirePackage{bvoutln}% outline of baskerville + \SingleColumnfalse + \RequirePackage{multicol} + \or + % \Status = 4 + \typeout{TeX Live documentation as a TUB article} + \@ifundefined{Fonts}% + {\RequirePackage{ae}}% + {\RequirePackage[T1]{\Fonts}} + \SingleColumnfalse + \newenvironment{multicols}[1]{}{} +\fi +% +\ifnum \Status=4 +\else + \RequirePackage{texnames} + \providecommand\TeXXeT{\TeX-{}-% + \kern-.1emX\kern-.125em\lower.5ex\hbox{E}\kern-.1667emT\@} + \def\MP{MetaPost} + \let\mf\MF + \newcommand\ConTeXt{C\kern-.0333emon\-\kern-.0667em\TeX\kern-.0333emt} + \newcommand\MIKTEX{MiK\kern-.025em \TeX}% per www.miktex.org + % from pictex.tex: + \ifx\PiC\undefined \def\PiC{P\kern-.12em\lower.5ex\hbox{I}\kern-.075emC} \fi + \ifx\PiCTeX\undefined \def\PiCTeX{\PiC\kern-.11em\TeX} \fi +\fi +% +% hacking at sections etc., to pay attention to baskerville status +\newcommand{\@condend@multicols}{% + \ifSingleColumn + \else + \def\@tempa{multicols}% + \ifx\@tempa\@currenvir + \end{multicols}% + \fi + \fi +} +\let\Section\section +\renewcommand{\section}{% + \@ifstar + {\Section*}% + {% + \@condend@multicols + \@dblarg\@full@section + }% +} +\def\@full@section[#1]#2{% + \Section[#1]{#2}% + \ifSingleColumn\else\begin{multicols}{2}\fi +} +\let\SubSection\subsection +\renewcommand{\subsection}{% + \@ifstar{\SubSection*}% + {% + \@condend@multicols + \@dblarg\@full@subsection + } +} +\def\@full@subsection[#1]#2{% + \SubSection[#1]{#2}% + \ifSingleColumn\else\begin{multicols}{2}\fi +} + +% calm things down a bit if we're in a multiple-column version +\ifSingleColumn +\else + \def\@listI{\leftmargin\leftmargini + \parsep \z@ + \topsep 2\p@ \@plus 1\p@ \@minus 1\p@ + \itemsep \z@ \@plus .1\p@ + } + \let\@listi\@listI + \@listi + \def\@listii{\leftmargin\leftmarginii + \labelwidth\leftmarginii\advance\labelwidth-\labelsep + \topsep 2\p@ \@plus 1\p@ \@minus 1\p@ + \parsep \z@ + \itemsep \z@ \@plus .1\p@ + } + \def\@listiii{\leftmargin\leftmarginiii + \labelwidth\leftmarginiii\advance\labelwidth-\labelsep + \topsep 1\p@ \@plus 1\p@ \@minus 1\p@ + \parsep \z@ + \partopsep \z@ + \itemsep \topsep + } + \def\@listiv{\leftmargin\leftmarginiv + \labelwidth\leftmarginiv\advance\labelwidth-\labelsep + } + \def\@listv{\leftmargin\leftmarginv + \labelwidth\leftmarginv\advance\labelwidth-\labelsep + } + \def\@listvi{\leftmargin\leftmarginvi + \labelwidth\leftmarginvi\advance\labelwidth-\labelsep + } +\fi +% +% array package stuff +\def\arraybackslash{\let\\=\@arraycr} +\newcolumntype{P}[1]{>{\raggedright\arraybackslash}p{#1}} +% +% shaded rows (using facilities of colortbl) +% +\definecolor{pale}{gray}{.9} +\newcount\colrow +\gdef\RowColor{pale} +\def\SetRowColor{% + \rowcolor{\RowColor}% + \global\advance\colrow by1\relax + \ifodd\colrow + \gdef\RowColor{pale}% + \else + \gdef\RowColor{white}% + \fi +} +% redefine to hack up a reference even though we don't need it... +\renewcommand\@bibitem[1]{\if@filesw \immediate\write\@auxout + {\string\bibcite{#1}{?}}\fi\ignorespaces} +% +% \unknownTeXlive is a dummy texlive entry for the biblio +\newcommand\unknownTeXlive[2][\relax]{\textbf{\textsc{unknown}}% + \global\@all@unknown\expandafter{\the\@all@unknown{#2}}% +} +\newtoks\@all@unknown +\global\@all@unknown{} +\AtEndDocument{\@message@unknowns} +\def\@message@unknowns{\edef\@tempa{\the\@all@unknown}% + \ifx\@tempa\@empty + \else + \def\@tempa{*** TeX Live package location of }% + \expandafter\@output@unknowns\the\@all@unknown\@empty + \fi +} +\def\@output@unknowns#1{\edef\@tempb{#1}% + \ifx\@tempb\@empty + \typeout{ unknown}% + \else + \message{\@tempa#1,}% + \def\@tempa{}% + \expandafter\@output@unknowns + \fi +} + + +% Silence font warnings about no bold typewriter in LM. +\def\@font@warning#1{}% + +% Silence hyperref warnings about \kern. +\def\HyPsd@Warning#1{}% + +\endinput diff --git a/Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.css b/Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.css new file mode 100644 index 00000000000..ba915268b0b --- /dev/null +++ b/Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.css @@ -0,0 +1,380 @@ + +/* start css.sty */ +.ec-lmr-17{font-size:170%;} +.ec-lmri-12x-x-172{font-size:206%; font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmss-17{font-size:170%; font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmr-12{font-size:120%;} +.ec-lmtt-12{font-size:120%; font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtt-8{font-size:80%; font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmtt-9{font-size:90%; font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmr-7{font-size:70%;} +.ec-lmtt-8x-x-87{font-size:69%; font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +.ec-lmtt-8x-x-87{ font-family: monospace;} +p.noindent { text-indent: 0em } +td p.noindent { text-indent: 0em; margin-top:0em; } +p.nopar { text-indent: 0em; } +p.indent{ text-indent: 1.5em } +@media print {div.crosslinks {visibility:hidden;}} +a img { border-top: 0; border-left: 0; border-right: 0; } +center { margin-top:1em; margin-bottom:1em; } +td center { margin-top:0em; margin-bottom:0em; } +.Canvas { position:relative; } +img.math{vertical-align:middle;} +li p.indent { text-indent: 0em } +li p:first-child{ margin-top:0em; } +li p:last-child, li div:last-child { margin-bottom:0.5em; } +li p~ul:last-child, li p~ol:last-child{ margin-bottom:0.5em; } +.enumerate1 {list-style-type:decimal;} +.enumerate2 {list-style-type:lower-alpha;} +.enumerate3 {list-style-type:lower-roman;} +.enumerate4 {list-style-type:upper-alpha;} +div.newtheorem { margin-bottom: 2em; margin-top: 2em;} +.obeylines-h,.obeylines-v {white-space: nowrap; } +div.obeylines-v p { margin-top:0; margin-bottom:0; } +.overline{ text-decoration:overline; } +.overline img{ border-top: 1px solid black; } +td.displaylines {text-align:center; white-space:nowrap;} +.centerline {text-align:center;} +.rightline {text-align:right;} +div.verbatim {font-family: monospace; white-space: nowrap; text-align:left; clear:both; } +.fbox {padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } +div.fbox {display:table} +div.center div.fbox {text-align:center; clear:both; padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } +div.minipage{width:100%;} +div.center, div.center div.center {text-align: center; margin-left:1em; margin-right:1em;} +div.center div {text-align: left;} +div.flushright, div.flushright div.flushright {text-align: right;} +div.flushright div {text-align: left;} +div.flushleft {text-align: left;} +.underline{ text-decoration:underline; } +.underline img{ border-bottom: 1px solid black; margin-bottom:1pt; } +.framebox-c, .framebox-l, .framebox-r { padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } +.framebox-c {text-align:center;} +.framebox-l {text-align:left;} +.framebox-r {text-align:right;} +span.thank-mark{ vertical-align: super } +span.footnote-mark sup.textsuperscript, span.footnote-mark a sup.textsuperscript{ font-size:80%; } +div.footnotes{border-top:solid 1px black; border-bottom:solid 1px black; padding-bottom:1ex; padding-top:0.5ex; margin-right:15%; margin-top:2ex; font-style:italic; font-size:85%;} +div.footnotes p{margin-top:0; margin-bottom:0; text-indent:0;} +div.tabular, div.center div.tabular {text-align: center; margin-top:0.5em; margin-bottom:0.5em; } +table.tabular td p{margin-top:0em;} +table.tabular {margin-left: auto; margin-right: auto;} +td p:first-child{ margin-top:0em; } +td p:last-child{ margin-bottom:0em; } +div.td00{ margin-left:0pt; margin-right:0pt; } +div.td01{ margin-left:0pt; margin-right:5pt; } +div.td10{ margin-left:5pt; margin-right:0pt; } +div.td11{ margin-left:5pt; margin-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +td.td00{ padding-left:0pt; padding-right:0pt; } +td.td01{ padding-left:0pt; padding-right:5pt; } +td.td10{ padding-left:5pt; padding-right:0pt; } +td.td11{ padding-left:5pt; padding-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +.hline hr, .cline hr{ height : 1px; margin:0px; } +.tabbing-right {text-align:right;} +span.TEX {letter-spacing: -0.125em; } +span.TEX span.E{ position:relative;top:0.5ex;left:-0.0417em;} +a span.TEX span.E {text-decoration: none; } +span.LATEX span.A{ position:relative; top:-0.5ex; left:-0.4em; font-size:85%;} +span.LATEX span.TEX{ position:relative; left: -0.4em; } +div.float, div.figure {margin-left: auto; margin-right: auto;} +div.float img {text-align:center;} +div.figure img {text-align:center;} +.marginpar {width:20%; float:right; text-align:left; margin-left:auto; margin-top:0.5em; font-size:85%; text-decoration:underline;} +.marginpar p{margin-top:0.4em; margin-bottom:0.4em;} +table.equation {width:100%;} +.equation td{text-align:center; } +td.equation { margin-top:1em; margin-bottom:1em; } +td.equation-label { width:5%; text-align:center; } +td.eqnarray4 { width:5%; white-space: normal; } +td.eqnarray2 { width:5%; } +table.eqnarray-star, table.eqnarray {width:100%;} +div.eqnarray{text-align:center;} +div.array {text-align:center;} +div.pmatrix {text-align:center;} +table.pmatrix {width:100%;} +span.pmatrix img{vertical-align:middle;} +div.pmatrix {text-align:center;} +table.pmatrix {width:100%;} +span.bar-css {text-decoration:overline;} +img.cdots{vertical-align:middle;} +div.tabular, div.center div.tabular {text-align: center; margin-top:0.5em; margin-bottom:0.5em; } +table.tabular td p{margin-top:0em;} +table.tabular {margin-left: auto; margin-right: auto;} +td p:first-child{ margin-top:0em; } +td p:last-child{ margin-bottom:0em; } +div.td00{ margin-left:0pt; margin-right:0pt; } +div.td01{ margin-left:0pt; margin-right:5pt; } +div.td10{ margin-left:5pt; margin-right:0pt; } +div.td11{ margin-left:5pt; margin-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +td.td00{ padding-left:0pt; padding-right:0pt; } +td.td01{ padding-left:0pt; padding-right:5pt; } +td.td10{ padding-left:5pt; padding-right:0pt; } +td.td11{ padding-left:5pt; padding-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +.hline hr, .cline hr{ height : 1px; margin:0px; } +div.array {text-align:center;} +.partToc a, .partToc, .likepartToc a, .likepartToc {line-height: 200%; font-weight:bold; font-size:110%;} +.index-item, .index-subitem, .index-subsubitem {display:block} +div.caption {text-indent:-2em; margin-left:3em; margin-right:1em; text-align:left;} +div.caption span.id{font-weight: bold; white-space: nowrap; } +h1.partHead{text-align: center} +p.bibitem { text-indent: -2em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; } +p.bibitem-p { text-indent: 0em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; } +.paragraphHead, .likeparagraphHead { margin-top:2em; font-weight: bold;} +.subparagraphHead, .likesubparagraphHead { font-weight: bold;} +.quote {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; margin-right:1em; text-align:justify;} +.verse{white-space:nowrap; margin-left:2em} +div.maketitle {text-align:center;} +h2.titleHead{text-align:center;} +div.maketitle{ margin-bottom: 2em; } +div.author, div.date {text-align:center;} +div.thanks{text-align:left; margin-left:10%; font-size:85%; font-style:italic; } +.quotation {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; } +.abstract p {margin-left:5%; margin-right:5%;} +div.abstract {width:100%;} +.alltt P { margin-bottom : 0em; margin-top : 0em; } +.alltt { margin-bottom : 1em; margin-top : 1em; } +.figure img.graphics {margin-left:10%;} +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +div.longtable{text-align:center;} +.uline{ text-decoration:underline; } +.uuline{ text-decoration:underline; } +span.sout {text-decoration: line-through } +span.xout {text-decoration: line-through } +span.uwave {text-decoration:underline } +P.fancyvrb {white-space: nowrap; margin:0em;} +div#fancyvrb1{ border-top: solid 0.4pt; } +div#fancyvrb1{ border-left: solid 0.4pt; } +div#fancyvrb1{ border-bottom: solid 0.4pt; } +div#fancyvrb1{ border-right: solid 0.4pt; } +div#fancyvrb2{ border-top: solid 0.4pt; } +div#fancyvrb2{ border-left: solid 0.4pt; } +div#fancyvrb2{ border-bottom: solid 0.4pt; } +div#fancyvrb2{ border-right: solid 0.4pt; } +div#fancyvrb3{ border-top: solid 0.4pt; } +div#fancyvrb3{ border-left: solid 0.4pt; } +div#fancyvrb3{ border-bottom: solid 0.4pt; } +div#fancyvrb3{ border-right: solid 0.4pt; } +div#fancyvrb4{ border-top: solid 0.4pt; } +div#fancyvrb4{ border-left: solid 0.4pt; } +div#fancyvrb4{ border-bottom: solid 0.4pt; } +div#fancyvrb4{ border-right: solid 0.4pt; } +/* end css.sty */ + diff --git a/Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.html b/Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.html new file mode 100644 index 00000000000..0e2ea49f78d --- /dev/null +++ b/Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.html @@ -0,0 +1,6942 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" + "http://www.w3.org/TR/html4/loose.dtd"> +<html > +<head> + <title>Przewodnik po TEX Live +TeX Live 2012 </title> +<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-2"> +<meta name="generator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)"> +<meta name="originator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)"> +<!-- charset=iso-8859-1,html,info,fn-in --> +<meta name="src" content="texlive-pl.tex"> +<meta name="date" content="2012-06-04 20:23:00"> +<link rel="stylesheet" type="text/css" href="texlive-pl.css"> +<link rel="stylesheet" type="text/css" href="texlive-pl.css" > +<link rel="stylesheet" type="text/css" href="tex-live.css" > +</head><body +> + <div class="maketitle"> + + + + + +<h2 class="titleHead">Przewodnik po <span class="TEX">T<span +class="E">E</span>X</span> Live<br /> +<span class="TEX">T<span +class="E">E</span>X</span> Live 2012 </h2> + <div class="author" ><span +class="ec-lmr-12">Redakcja: Karl Berry</span> +<br /> <a +href="http://tug.org/texlive/" class="url" ><span +class="ec-lmtt-12">http://tug.org/texlive/</span></a> </div><br /> +<div class="date" ><span +class="ec-lmr-12">Czerwiec 2012</span></div> + </div> + <h3 class="likesectionHead"><a + id="x1-1000"></a>Spis treści</h3> + <div class="tableofcontents"> + <span class="sectionToc" >1 <a +href="#x1-20001" id="QQ2-1-2">Wstęp</a></span> +<br />  <span class="subsectionToc" >1.1 <a +href="#x1-30001.1" id="QQ2-1-3">TEX Live i TEX Collection</a></span> +<br />  <span class="subsectionToc" >1.2 <a +href="#x1-40001.2" id="QQ2-1-4">Obsługiwane systemy operacyjne</a></span> +<br />  <span class="subsectionToc" >1.3 <a +href="#x1-50001.3" id="QQ2-1-5">Podstawy instalacji <span class="TEX">T<span +class="E">E</span>X</span> Live</a></span> +<br />  <span class="subsectionToc" >1.4 <a +href="#x1-60001.4" id="QQ2-1-6">Uwagi dotyczące bezpieczeństwa</a></span> +<br />  <span class="subsectionToc" >1.5 <a +href="#x1-70001.5" id="QQ2-1-7">Dostępna pomoc</a></span> +<br /> <span class="sectionToc" >2 <a +href="#x1-80002" id="QQ2-1-8">Struktura <span class="TEX">T<span +class="E">E</span>X</span> Live</a></span> +<br />  <span class="subsectionToc" >2.1 <a +href="#x1-90002.1" id="QQ2-1-9"><span class="TEX">T<span +class="E">E</span>X</span> Collection: TEX Live, proTEXt, MacTEX</a></span> +<br />  <span class="subsectionToc" >2.2 <a +href="#x1-100002.2" id="QQ2-1-10">Główne katalogi TEX Live</a></span> +<br />  <span class="subsectionToc" >2.3 <a +href="#x1-110002.3" id="QQ2-1-11">Predefiniowane drzewa katalogów texmf</a></span> +<br />  <span class="subsectionToc" >2.4 <a +href="#x1-120002.4" id="QQ2-1-12">Rozszerzenia <span class="TEX">T<span +class="E">E</span>X</span>-a</a></span> +<br />  <span class="subsectionToc" >2.5 <a +href="#x1-130002.5" id="QQ2-1-13">Inne ważniejsze programy <span class="TEX">T<span +class="E">E</span>X</span> Live</a></span> +<br />  <span class="subsectionToc" >2.6 <a +href="#x1-140002.6" id="QQ2-1-14">Pakiety i ich zestawy</a></span> +<br />  <span class="subsectionToc" >2.7 <a +href="#x1-150002.7" id="QQ2-1-16">Fonty w <span class="TEX">T<span +class="E">E</span>X</span> Live</a></span> +<br /> <span class="sectionToc" >3 <a +href="#x1-160003" id="QQ2-1-17">Instalacja</a></span> +<br />  <span class="subsectionToc" >3.1 <a +href="#x1-170003.1" id="QQ2-1-18">Start instalacji</a></span> +<br />   <span class="subsubsectionToc" >3.1.1 <a +href="#x1-180003.1.1" id="QQ2-1-19">Unix</a></span> +<br />   <span class="subsubsectionToc" >3.1.2 <a +href="#x1-190003.1.2" id="QQ2-1-21">MacOSX</a></span> +<br />   <span class="subsubsectionToc" >3.1.3 <a +href="#x1-200003.1.3" id="QQ2-1-22">Windows</a></span> +<br />   <span class="subsubsectionToc" >3.1.4 <a +href="#x1-210003.1.4" id="QQ2-1-24">Cygwin</a></span> +<br />   <span class="subsubsectionToc" >3.1.5 <a +href="#x1-220003.1.5" id="QQ2-1-25">Instalator w trybie tekstowym</a></span> +<br />   <span class="subsubsectionToc" >3.1.6 <a +href="#x1-230003.1.6" id="QQ2-1-26">Zaawansowany program instalacyjny w trybie graficznym</a></span> +<br />   <span class="subsubsectionToc" >3.1.7 <a +href="#x1-240003.1.7" id="QQ2-1-27">Uproszczony program instalacyjny</a></span> +<br />  <span class="subsectionToc" >3.2 <a +href="#x1-250003.2" id="QQ2-1-28">Podczas instalacji</a></span> +<br />   <span class="subsubsectionToc" >3.2.1 <a +href="#x1-260003.2.1" id="QQ2-1-29">Menu: binary systems (tylko Unix)</a></span> +<br />   <span class="subsubsectionToc" >3.2.2 <a +href="#x1-270003.2.2" id="QQ2-1-31">Wybór składników do instalacji</a></span> +<br />   <span class="subsubsectionToc" >3.2.3 <a +href="#x1-280003.2.3" id="QQ2-1-34">Katalogi</a></span> +<br />   <span class="subsubsectionToc" >3.2.4 <a +href="#x1-290003.2.4" id="QQ2-1-35">Opcje</a></span> +<br />  <span class="subsectionToc" >3.3 <a +href="#x1-300003.3" id="QQ2-1-37">Parametry instalacji z linii poleceń</a></span> +<br />   <span class="subsubsectionToc" >3.3.1 <a +href="#x1-310003.3.1" id="QQ2-1-38">Parametr <span +class="ec-lmtt-10">-repository</span></a></span> +<br />  <span class="subsectionToc" >3.4 <a +href="#x1-320003.4" id="QQ2-1-39">Czynności poinstalacyjne</a></span> +<br />   <span class="subsubsectionToc" >3.4.1 <a +href="#x1-330003.4.1" id="QQ2-1-40">Zmienne środowiska dla Unix</a></span> +<br />   <span class="subsubsectionToc" >3.4.2 <a +href="#x1-340003.4.2" id="QQ2-1-41">Zmienne środowiska: konfiguracja globalna</a></span> +<br />   <span class="subsubsectionToc" >3.4.3 <a +href="#x1-350003.4.3" id="QQ2-1-42">Aktualizacje z internetu po instalacji z DVD</a></span> +<br />   <span class="subsubsectionToc" >3.4.4 <a +href="#x1-360003.4.4" id="QQ2-1-43">Konfiguracja fontów dla XeTEX i LuaTEX</a></span> +<br />   <span class="subsubsectionToc" >3.4.5 <a +href="#x1-370003.4.5" id="QQ2-1-44">ConTEXt Mark IV</a></span> + + +<br />   <span class="subsubsectionToc" >3.4.6 <a +href="#x1-380003.4.6" id="QQ2-1-45">Integracja lokalnych i prywatnych pakietów makr</a></span> +<br />   <span class="subsubsectionToc" >3.4.7 <a +href="#x1-390003.4.7" id="QQ2-1-46">Integracja fontów z innych źródeł</a></span> +<br />  <span class="subsectionToc" >3.5 <a +href="#x1-400003.5" id="QQ2-1-47">Testowanie instalacji</a></span> +<br />  <span class="subsectionToc" >3.6 <a +href="#x1-410003.6" id="QQ2-1-48">Programy pomocnicze dla Windows</a></span> +<br /> <span class="sectionToc" >4 <a +href="#x1-420004" id="QQ2-1-50">Instalacje zaawansowane</a></span> +<br />  <span class="subsectionToc" >4.1 <a +href="#x1-430004.1" id="QQ2-1-51">Instalacje dla wielu użytkowników (lub wieloplatformowe)</a></span> +<br />  <span class="subsectionToc" >4.2 <a +href="#x1-440004.2" id="QQ2-1-52">Przenośna instalacja na pen drivie USB</a></span> +<br />  <span class="subsectionToc" >4.3 <a +href="#x1-450004.3" id="QQ2-1-53">Instalacje z pliku obrazu ISO (lub DVD)</a></span> +<br /> <span class="sectionToc" >5 <a +href="#x1-460005" id="QQ2-1-54"><span +class="ec-lmss-10">tlmgr</span>: zarządzanie instalacją</a></span> +<br />  <span class="subsectionToc" >5.1 <a +href="#x1-470005.1" id="QQ2-1-58"><span +class="ec-lmss-10">tlmgr </span>– tryb graficzny (GUI)</a></span> +<br />  <span class="subsectionToc" >5.2 <a +href="#x1-480005.2" id="QQ2-1-59">Przykładowe wywołania <span +class="ec-lmss-10">tlmgr </span>z linii poleceń</a></span> +<br /> <span class="sectionToc" >6 <a +href="#x1-490006" id="QQ2-1-60">Uwagi dotyczące Windows</a></span> +<br />  <span class="subsectionToc" >6.1 <a +href="#x1-500006.1" id="QQ2-1-61">Cechy specyficzne w systemie Windows</a></span> +<br />  <span class="subsectionToc" >6.2 <a +href="#x1-510006.2" id="QQ2-1-62">User Profile to inaczej Home (katalog domowy)</a></span> +<br />  <span class="subsectionToc" >6.3 <a +href="#x1-520006.3" id="QQ2-1-63">Rejestr Windows</a></span> +<br />  <span class="subsectionToc" >6.4 <a +href="#x1-530006.4" id="QQ2-1-64">Uprawnienia w Windows</a></span> +<br />  <span class="subsectionToc" >6.5 <a +href="#x1-540006.5" id="QQ2-1-65">Zwiększanie maksymalnej ilości dostępnej pamięci w Windows i Cygwin</a></span> +<br /> <span class="sectionToc" >7 <a +href="#x1-550007" id="QQ2-1-66">W razie problemów</a></span> +<br />  <span class="subsectionToc" >7.1 <a +href="#x1-560007.1" id="QQ2-1-67">Co zrobić gdy <span +class="ec-lmtt-10">latex </span>nie może znaleźć potrzebnych plików?</a></span> +<br /> <span class="sectionToc" >8 <a +href="#x1-570008" id="QQ2-1-68">Instrukcja obsługi systemu Web2C</a></span> +<br />  <span class="subsectionToc" >8.1 <a +href="#x1-580008.1" id="QQ2-1-69">Przeszukiwanie ścieżek przez Kpathsea</a></span> +<br />   <span class="subsubsectionToc" >8.1.1 <a +href="#x1-590008.1.1" id="QQ2-1-70">Źródła ścieżek</a></span> +<br />   <span class="subsubsectionToc" >8.1.2 <a +href="#x1-600008.1.2" id="QQ2-1-71">Pliki konfiguracyjne</a></span> +<br />   <span class="subsubsectionToc" >8.1.3 <a +href="#x1-610008.1.3" id="QQ2-1-72">Rozwijanie ścieżek</a></span> +<br />   <span class="subsubsectionToc" >8.1.4 <a +href="#x1-620008.1.4" id="QQ2-1-73">Rozwijanie domyślne</a></span> +<br />   <span class="subsubsectionToc" >8.1.5 <a +href="#x1-630008.1.5" id="QQ2-1-74">Rozwijanie nawiasów</a></span> +<br />   <span class="subsubsectionToc" >8.1.6 <a +href="#x1-640008.1.6" id="QQ2-1-75">Rozwijanie podkatalogów</a></span> +<br />   <span class="subsubsectionToc" >8.1.7 <a +href="#x1-650008.1.7" id="QQ2-1-76">Lista znaków specjalnych i ich znaczeń – podsumowanie</a></span> +<br />  <span class="subsectionToc" >8.2 <a +href="#x1-660008.2" id="QQ2-1-77">Bazy nazw plików</a></span> +<br />   <span class="subsubsectionToc" >8.2.1 <a +href="#x1-670008.2.1" id="QQ2-1-78">Baza nazw plików</a></span> +<br />   <span class="subsubsectionToc" >8.2.2 <a +href="#x1-680008.2.2" id="QQ2-1-79">kpsewhich – program do przeszukiwania ścieżek</a></span> +<br />   <span class="subsubsectionToc" >8.2.3 <a +href="#x1-690008.2.3" id="QQ2-1-80">Przykłady użycia</a></span> +<br />   <span class="subsubsectionToc" >8.2.4 <a +href="#x1-700008.2.4" id="QQ2-1-81">Diagnostyka błędów</a></span> +<br />  <span class="subsectionToc" >8.3 <a +href="#x1-710008.3" id="QQ2-1-85">Parametry kontrolujące działanie programów</a></span> +<br /> <span class="sectionToc" >9 <a +href="#x1-720009" id="QQ2-1-86">Budowa systemu na nowej platformie uniksowej</a></span> +<br />  <span class="subsectionToc" >9.1 <a +href="#x1-730009.1" id="QQ2-1-87">Warunki wstępne</a></span> +<br />  <span class="subsectionToc" >9.2 <a +href="#x1-740009.2" id="QQ2-1-88">Konfiguracja</a></span> +<br />  <span class="subsectionToc" >9.3 <a +href="#x1-750009.3" id="QQ2-1-89">Uruchamianie <span +class="ec-lmss-10">make</span></a></span> +<br />  <span class="subsectionToc" >9.4 <a +href="#x1-760009.4" id="QQ2-1-90">Końcowe kroki konfiguracyjne</a></span> +<br /> <span class="sectionToc" >10 <a +href="#x1-7700010" id="QQ2-1-91">Podziękowania</a></span> +<br /> <span class="sectionToc" >11 <a +href="#x1-7800011" id="QQ2-1-92">Historia</a></span> +<br />  <span class="subsectionToc" >11.1 <a +href="#x1-7900011.1" id="QQ2-1-93">Poprzednie wersje</a></span> +<br />  <span class="subsectionToc" >11.2 <a +href="#x1-8000011.2" id="QQ2-1-94">Wydanie 2004</a></span> +<br />  <span class="subsectionToc" >11.3 <a +href="#x1-8100011.3" id="QQ2-1-95">Wydanie 2005</a></span> +<br />  <span class="subsectionToc" >11.4 <a +href="#x1-8200011.4" id="QQ2-1-96">Wydanie 2006–2007</a></span> +<br />  <span class="subsectionToc" >11.5 <a +href="#x1-8300011.5" id="QQ2-1-97">Wydanie 2008</a></span> +<br />  <span class="subsectionToc" >11.6 <a +href="#x1-8400011.6" id="QQ2-1-98">Wydanie 2009</a></span> +<br />  <span class="subsectionToc" >11.7 <a +href="#x1-8500011.7" id="QQ2-1-99">Wydanie 2010</a></span> +<br />  <span class="subsectionToc" >11.8 <a +href="#x1-8600011.8" id="QQ2-1-100">Wydanie 2011</a></span> +<br />  <span class="subsectionToc" >11.9 <a +href="#x1-8700011.9" id="QQ2-1-101">Obecna edycja</a></span> +<br />  <span class="subsectionToc" >11.10 <a +href="#x1-8800011.10" id="QQ2-1-102"> Przyszłe wersje</a></span> + </div> + <h3 class="sectionHead"><span class="titlemark">1. </span> <a + id="x1-20001"></a>Wstęp</h3> + + +<!--l. 57--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">1.1. </span> <a + id="x1-30001.1"></a><span class="TEX">T<span +class="E">E</span>X</span> Live i <span class="TEX">T<span +class="E">E</span>X</span> Collection</h4> +<!--l. 58--><p class="noindent" >Niniejsza dokumentacja opisuje oprogramowanie <span class="TEX">T<span +class="E">E</span>X</span> Live – dystrybucję <span class="TEX">T<span +class="E">E</span>X</span>-a wraz z programami +pomocniczymi, dostępną dla różnych wersji Unix, w tym GNU/Linux, Mac OS X i Cygwin, oraz +Windows. +<!--l. 63--><p class="indent" > <span class="TEX">T<span +class="E">E</span>X</span> Live można ściągnąć z sieci bądź otrzymać na płytce DVD <span class="TEX">T<span +class="E">E</span>X</span> Collection, dostarczanej swoim +członkom przez Grupy Użytkowników Systemu <span class="TEX">T<span +class="E">E</span>X</span>. Część <a +href="#x1-90002.1">2.1<!--tex4ht:ref: sec:tl-coll-dists --></a> omawia pokrótce zawartość tej płytki. +Zarówno <span class="TEX">T<span +class="E">E</span>X</span> Live, jak i <span class="TEX">T<span +class="E">E</span>X</span> Collection powstały dzięki zbiorowemu wysiłkowi Grup. W tym dokumencie +omówimy głównie samą dystrybucję <span class="TEX">T<span +class="E">E</span>X</span> Live. +<!--l. 69--><p class="indent" > <span class="TEX">T<span +class="E">E</span>X</span> Live zawiera skompilowane programy: <span class="TEX">T<span +class="E">E</span>X</span>, LaTeX2e, Metafont, MetaPost, BibTeX i wiele innych +oraz bogaty zestaw pakietów makr o wielorakim zastosowaniu, a także fonty i dokumentacje. Wszystko to +umożliwia skład publikacji w wielu językach. +<!--l. 74--><p class="indent" > Pakiety zawarte w <span class="TEX">T<span +class="E">E</span>X</span> Live są regularnie aktualizowane z serwerów CTAN (<span +class="ec-lmri-10">Comprehensive TeX Archive</span> +<span +class="ec-lmri-10">Network</span>), które gromadzą wszelkie zasoby dotyczące systemu <span class="TEX">T<span +class="E">E</span>X</span>: <a +href="http://www.ctan.org" class="url" ><span +class="ec-lmtt-10">http://www.ctan.org</span></a>. +<!--l. 78--><p class="indent" > Lista najważniejszych zmian dokonanych w tej edycji <span class="TEX">T<span +class="E">E</span>X</span> Live znajduje się w części <a +href="#x1-8700011.9">11.9<!--tex4ht:ref: sec:tlcurrent --></a>, na +str. <a +href="#x1-8700011.9">92<!--tex4ht:ref: sec:tlcurrent --></a>. +<!--l. 81--><p class="indent" > Nie opisujemy tu, czym jest system <span class="TEX">T<span +class="E">E</span>X</span>, a jedynie kwestię instalacji i konfiguracji oprogramowania <span class="TEX">T<span +class="E">E</span>X</span> +Live. Początkujący użytkownicy mogą się zapoznać z podstawowymi pojęciami np. w artykule <span +class="ec-lmri-10">Przewodnik po</span> +<span +class="ec-lmri-10">systemie </span><span class="TEX"><span +class="ec-lmri-10">T</span><span +class="E"><span +class="ec-lmri-10">E</span></span><span +class="ec-lmri-10">X</span></span>: <a +href="../../../../texmf-dist/doc/generic/tex-virtual-academy-pl/cototex.html" >texmf-dist/doc/generic/tex-virtual-academy-pl/cototex.html</a>. +<!--l. 87--><p class="indent" > <a id="platforms"></a> + <h4 class="subsectionHead"><span class="titlemark">1.2. </span> <a + id="x1-40001.2"></a>Obsługiwane systemy operacyjne</h4> +<!--l. 91--><p class="noindent" ><span class="TEX">T<span +class="E">E</span>X</span> Live zawiera oprogramowanie dla wielu platform uniksowych, w tym GNU/Linux, Mac OS X +i Cygwin. Załączone pliki źródłowe pozwalają też na jego instalację na platformach innych systemów +operacyjnych. +<!--l. 95--><p class="indent" > Spośród systemów Windows obsługiwane są tylko XP i nowsze wersje (choć w Windows 2000 <span class="TEX">T<span +class="E">E</span>X</span> Live +też w zasadzie działa). Wprawdzie brak jest oprogramowania dedykowanego dla wersji 64-bitowych, ale +aplikacje 32-bitowe powinny na nich działać. +<!--l. 100--><p class="indent" > W części <a +href="#x1-90002.1">2.1<!--tex4ht:ref: sec:tl-coll-dists --></a> omówiono alternatywne dystrybucje, przeznaczone dla Windows oraz Mac OS X. +<!--l. 103--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">1.3. </span> <a + id="x1-50001.3"></a>Podstawy instalacji <span class="TEX">T<span +class="E">E</span>X</span> Live</h4> +<!--l. 106--><p class="noindent" ><span class="TEX">T<span +class="E">E</span>X</span> Live można zainstalować z płytki DVD lub internetu (<a +href="http://tug.org/texlive/acquire.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/acquire.html</span></a>). +Program instalacyjny jest niewielki i pozwala pobrać z sieci wszystkie potrzebne pakiety. Jest to wygodne, +zwłaszcza gdy potrzebujemy jedynie części oprogramowania <span class="TEX">T<span +class="E">E</span>X</span> Live i nie chcemy pobierać niepotrzebnie +obrazu całej płyty instalacyjnej. +<!--l. 112--><p class="indent" > Posiadając płytkę <span class="TEX">T<span +class="E">E</span>X</span> Collection DVD (lub jej obraz w pliku <span +class="ec-lmtt-10">.iso</span>) możemy jedynie zaistalować <span class="TEX">T<span +class="E">E</span>X</span> +Live na twardym dysku, lub przygotować przenośną instalację np. na pen drivie (patrz część <a +href="#x1-440004.2">4.2<!--tex4ht:ref: sec:portable-tl --></a>). +Szczegółowy opis instalacji <span class="TEX">T<span +class="E">E</span>X</span> Live znajduje się w dalszych rozdziałach tego dokumentu, tu podamy +skrócony przepis: + <ul class="itemize1"> + <li class="itemize">program instalacyjny <span +class="ec-lmtt-10">install-tl </span>może działać w kilku trybach: tzw. „wizard” (graficznym, + parametr <span +class="ec-lmtt-10">-gui=wizard</span>) – domyślnym dla Windows; tekstowym (<span +class="ec-lmtt-10">-gui=text</span>, domyślnym dla + Unix/Linux) i graficznym trybie „expert” (parametr <span +class="ec-lmtt-10">-gui=perltk</span>). Dla wygody użytkowników + Windows uruchomienie <span +class="ec-lmtt-10">install-tl-advanced.bat </span>przełącza instalator w tryb „expert”. + </li> + <li class="itemize">jednym z instalowanych programów jest <span +class="ec-lmss-10">tlmgr </span>(menedżer <span class="TEX">T<span +class="E">E</span>X</span> Live), który również można + uruchamiać 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. + </li></ul> +<!--l. 136--><p class="indent" > <a id="security"></a> + + + <h4 class="subsectionHead"><span class="titlemark">1.4. </span> <a + id="x1-60001.4"></a>Uwagi dotyczące bezpieczeństwa</h4> +<!--l. 140--><p class="noindent" >Zgodnie z naszą najlepszą wiedzą, główne programy <span class="TEX">T<span +class="E">E</span>X</span>-owe są (i zawsze były) nadzwyczaj odporne. Jednak +mimo dokładania najwyższej staranności, inne programy wspierające, zawarte w <span class="TEX">T<span +class="E">E</span>X</span> Live, nie zawsze +osiągają ten sam poziom. Jak zawsze, należy być ostrożnym przy uruchamianiu programów z danymi +pochodzącymi z niepewnych źródeł. Dla uzyskania najwyższego stopnia bezpieczeństwa zalecamy stosowania +podczas pracy nowych podfolderów. +<!--l. 148--><p class="indent" > Konieczność zachowania staranności jest szczególnie ważna w systemie Windows, ponieważ +niezależnie od zawartości ścieżki przeszukiwania poszukuje on programów zawsze najpierw w bieżącym +folderze. To zachowanie systemu otwiera szerokie możliwości ataku. Usunęliśmy wiele luk, lecz +niewątpliwie niektóre jeszcze pozostały, szczególnie przy uruchamianiu programów pochodzących +z innych źródeł. Zalecamy więc sprawdzanie bieżących folderów pod kątem obecności podejrzanych +plików, w szczególności plików wykonywalnych (binarnych lub skryptów). Zwykle nie powinno +ich być, a w szczególności nie powinny być one tworzone w wyniku zwykłego przetwarzania +dokumentów. +<!--l. 159--><p class="indent" > I na koniec: <span class="TEX">T<span +class="E">E</span>X</span> (oraz towarzyszące mu programy) mogą tworzyć pliki przy przetwarzaniu dokumentów. +Własność ta jest na wiele różnych sposobów podatna na nadużycia. Także w tych przypadkach, +przetwarzanie nieznanych dokumentów w nowych podfolderach jest najlepszym znanym sposobem +zabezpieczenia. +<!--l. 165--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">1.5. </span> <a + id="x1-70001.5"></a>Dostępna pomoc</h4> +<!--l. 168--><p class="noindent" >Społeczność <span class="TEX">T<span +class="E">E</span>X</span>-owa jest bardzo aktywna i pomocna, stąd też większość poważnych zapytań nie pozostaje +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. +(Jeśli preferujemy komercyjne wsparcie techniczne, możemy zamiast <span class="TEX">T<span +class="E">E</span>X</span> Live zakupić system u jednego +z dostawców, których listę można znaleźć na <a +href="http://tug.org/interest.html#vendors" class="url" ><span +class="ec-lmtt-10">http://tug.org/interest.html#vendors</span></a>.) +<!--l. 177--><p class="indent" > Oto lista źródeł pomocy, w kolejności przez nas rekomendowanej: +<!--l. 179--><p class="indent" > + <dl class="description"><dt class="description"> +<span class="TEX"><span +class="ec-lmbx-10">T</span><span +class="E"><span +class="ec-lmbx-10">E</span></span><span +class="ec-lmbx-10">X</span></span> <span +class="ec-lmbx-10">FAQ</span> </dt><dd +class="description"><span class="TEX">T<span +class="E">E</span>X</span>-owy FAQ jest obszernym zbiorem odpowiedzi na wiele pytań, od najprostszych do + najbardziej zaawansowanych. Jest on + załączony na <span class="TEX">T<span +class="E">E</span>X</span> Live w katalogu <a +href="../../../../texmf-dist/doc/generic/FAQ-en/html/index.html" >texmf-dist/doc/generic/FAQ-en/html/index.html</a>, a także + dostępny w sieci: <a +href="http://www.tex.ac.uk/faq" class="url" ><span +class="ec-lmtt-10">http://www.tex.ac.uk/faq</span></a>. Proponujemy zajrzeć najpierw tam. Uruchomiono + też serwis FAQ w języku polskim: <a +href="http://faq.gust.org.pl" class="url" ><span +class="ec-lmtt-10">http://faq.gust.org.pl</span></a>. + </dd><dt class="description"> +<span class="TEX"><span +class="ec-lmbx-10">T</span><span +class="E"><span +class="ec-lmbx-10">E</span></span><span +class="ec-lmbx-10">X</span></span> <span +class="ec-lmbx-10">Catalogue</span> </dt><dd +class="description">Jeśli poszukujemy konkretnego pakietu, fontu, programu itp., to polecamy <span class="TEX">T<span +class="E">E</span>X</span> + Catalogue. Jest to obszerne zestawienie wszelkich pakietów dotyczących <span class="TEX">T<span +class="E">E</span>X</span>-a. Patrz: + <a +href="http://mirror.ctan.org/help/Catalogue/" class="url" ><span +class="ec-lmtt-10">http://mirror.ctan.org/help/Catalogue/</span></a>. + </dd><dt class="description"> +<span class="TEX"><span +class="ec-lmbx-10">T</span><span +class="E"><span +class="ec-lmbx-10">E</span></span><span +class="ec-lmbx-10">X</span></span> <span +class="ec-lmbx-10">Web Resources</span> </dt><dd +class="description">Strona <a +href="http://tug.org/interest.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/interest.html</span></a> zawiera wiele odsyłaczy, + w szczególności do książek, podręczników i artykułów poświęconych wszelkim aspektom pracy + z systemem <span class="TEX">T<span +class="E">E</span>X</span>. + </dd><dt class="description"> +<span +class="ec-lmbx-10">archiwa pomocy</span> </dt><dd +class="description"> + Dwa główne fora pomocy to grupa Usenet <a +href="news:comp.text.tex" class="url" ><span +class="ec-lmtt-10">news:comp.text.tex</span></a> oraz lista dyskusyjna <a +href="mailto:texhax@tug.org" ><span class="path"><span +class="ec-lmtt-10">texhax@</span> + <span +class="ec-lmtt-10">tug.org</span></span></a>. Warto przeszukać archiwa list dyskusyjnych, zawierające wiele pytań i odpowiedzi + zbieranych przez wiele lat: <a +href="http://groups.google.com/group/comp.text.tex/topics" class="url" ><span +class="ec-lmtt-10">http://groups.google.com/group/comp.text.tex/topics</span></a> oraz + <a +href="http://tug.org/mail-archives/texhax" class="url" ><span +class="ec-lmtt-10">http://tug.org/mail-archives/texhax</span></a>. Nie zaszkodzi skorzystanie z wyszukiwarki, np. + <a +href="http://www.google.com" class="url" ><span +class="ec-lmtt-10">http://www.google.com</span></a>. + </dd><dt class="description"> +<span +class="ec-lmbx-10">wysyłanie pyta</span><span +class="ec-lmbx-10">ń</span> </dt><dd +class="description">Jeśli nadal nie znajdujemy rozwiązania problemu, to możemy wysłać pytanie do + <span +class="ec-lmtt-10">comp.text.tex</span>, korzystając z Google, czytnika wiadomości bądź pisząc list na adres <a +href="mailto:texhax@tug.org" ><span class="path"><span +class="ec-lmtt-10">texhax@</span> + <span +class="ec-lmtt-10">tug.org</span></span></a>. Przedtem jednak <span +class="ec-lmri-10">nale</span><span +class="ec-lmri-10">ży </span>zapoznać się z poradami dotyczącymi sposobu zadawania + pytań, zawartymi w FAQ: <a +href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion" class="url" ><span +class="ec-lmtt-10">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion</span></a>. + + + Warto wspomnieć stronę <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> Community (<a +href="http://www.latex-community.org/" class="url" ><span +class="ec-lmtt-10">http://www.latex-community.org/</span></a>), forum + <a +href="http://www.latex-community.org/forum/" class="url" ><span +class="ec-lmtt-10">http://www.latex-community.org/forum/</span></a> oraz <span class="TEX">T<span +class="E">E</span>X</span> StackExchange + (<a +href="http://tex.stackexchange.com/" class="url" ><span +class="ec-lmtt-10">http://tex.stackexchange.com/</span></a>). Polscy użytkownicy mają do dyspozycji listę dyskusyjną + GUST (polskiej Grupy Użytkowników Systemu <span class="TEX">T<span +class="E">E</span>X</span>); informacje o niej znajdziemy na stronie + <a +href="http://www.gust.org.pl" class="url" ><span +class="ec-lmtt-10">http://www.gust.org.pl</span></a>. + </dd><dt class="description"> +<span +class="ec-lmbx-10">wsparcie ze strony społeczno</span><span +class="ec-lmbx-10">ści </span><span class="TEX"><span +class="ec-lmbx-10">T</span><span +class="E"><span +class="ec-lmbx-10">E</span></span><span +class="ec-lmbx-10">X</span></span> <span +class="ec-lmbx-10">Live</span> </dt><dd +class="description">Gdy chcemy zgłosić błąd bądź sugestie i komentarze + dotyczące dystrybucji <span class="TEX">T<span +class="E">E</span>X</span> Live, instalacji lub dokumentacji, mamy do dyspozycji listę dyskusyjną + <a +href="mailto:tex-live@tug.org" ><span class="path"><span +class="ec-lmtt-10">tex-live@tug.org</span></span></a>. Jeśli kwestia dotyczy konkretnego programu (pakietu makr itp.) z <span class="TEX">T<span +class="E">E</span>X</span> + Live, to lepiej jednak skierować pytanie do osoby opiekującej się danym programem lub na + specjalistyczną listę dyskusyjną. + </dd></dl> +<!--l. 229--><p class="indent" > Druga strona medalu to pomaganie tym, którzy mają problemy. Zarówno <span +class="ec-lmtt-10">comp.text.tex</span>, jak i <span +class="ec-lmtt-10">texhax</span> +(oraz lista dyskusyjna GUST) są otwarte dla każdego, tak więc zapraszamy do włączenia się, czytania +wiadomości i pomagania innym w miarę własnych możliwości. Witamy wśród użytkowników systemu +<span class="TEX">T<span +class="E">E</span>X</span>! +<!--l. 237--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">2. </span> <a + id="x1-80002"></a>Struktura <span class="TEX">T<span +class="E">E</span>X</span> Live</h3> +<!--l. 240--><p class="noindent" >Omówimy tutaj strukturę i zawartość dystrybucji <span class="TEX">T<span +class="E">E</span>X</span> Live, a także <span class="TEX">T<span +class="E">E</span>X</span> Collection – płytki DVD, w skład +której wchodzi <span class="TEX">T<span +class="E">E</span>X</span> Live. +<!--l. 243--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">2.1. </span> <a + id="x1-90002.1"></a><span class="TEX">T<span +class="E">E</span>X</span> Collection: <span class="TEX">T<span +class="E">E</span>X</span> Live, pro<span class="TEX">T<span +class="E">E</span>X</span>t, Mac<span class="TEX">T<span +class="E">E</span>X</span></h4> +<!--l. 246--><p class="noindent" ><span class="TEX">T<span +class="E">E</span>X</span> Collection DVD zawiera: +<!--l. 248--><p class="indent" > + <dl class="description"><dt class="description"> +<span class="TEX"><span +class="ec-lmbx-10">T</span><span +class="E"><span +class="ec-lmbx-10">E</span></span><span +class="ec-lmbx-10">X</span></span> <span +class="ec-lmbx-10">Live</span> </dt><dd +class="description">kompletny system na DVD, pozwala na instalację na twardym dysku lub przygotowanie + przenośnej instalacji np. na pen drivie; strona domowa projektu: <a +href="http://tug.org/texlive/" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/</span></a>. + </dd><dt class="description"> +<span +class="ec-lmbx-10">Mac</span><span class="TEX"><span +class="ec-lmbx-10">T</span><span +class="E"><span +class="ec-lmbx-10">E</span></span><span +class="ec-lmbx-10">X</span></span> </dt><dd +class="description">dla systemu Mac OS X; posiada własny program instalacyjny i dodatkowe programy dla + tego systemu; strona domowa projektu: <a +href="http://tug.org/mactex/" class="url" ><span +class="ec-lmtt-10">http://tug.org/mactex/</span></a>; + </dd><dt class="description"> +<span +class="ec-lmbx-10">pro</span><span class="TEX"><span +class="ec-lmbx-10">T</span><span +class="E"><span +class="ec-lmbx-10">E</span></span><span +class="ec-lmbx-10">X</span></span><span +class="ec-lmbx-10">t</span> </dt><dd +class="description">dystrybucja dla Windows, oparta na dystrybucji MiK<span class="TEX">T<span +class="E">E</span>X</span>, rozszerzonej o dodatkowe + narzędzia; całkowicie niezależna od <span class="TEX">T<span +class="E">E</span>X</span> Live; pro<span class="TEX">T<span +class="E">E</span>X</span>t posiada własny, łatwy w obsłudze + program instalacyjny; strona domowa projektu: <a +href="http://tug.org/protext" class="url" ><span +class="ec-lmtt-10">http://tug.org/protext</span></a>; + </dd><dt class="description"> +<span +class="ec-lmbx-10">CTAN</span> </dt><dd +class="description">zrzut zawartości archiwów CTAN; (<a +href="http://www.ctan.org" class="url" ><span +class="ec-lmtt-10">http://www.ctan.org</span></a>). + </dd><dt class="description"> +<span +class="ec-lmtk-10">texmf-extra</span> </dt><dd +class="description">katalog z wybranymi pakietami dodatkowymi. + </dd></dl> +<!--l. 270--><p class="indent" > CTAN, <span +class="ec-lmss-10">protext</span>, i <span +class="ec-lmtt-10">texmf-extra </span>nie spełniają przyjętych dla <span class="TEX">T<span +class="E">E</span>X</span> Live wymogów dotyczących swobody +kopiowania, wobec tego należy ten fakt uwzględnić przy redystrybucji bądź modyfikacji zawartości +wymienionych katalogów. + + +<!--l. 275--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">2.2. </span> <a + id="x1-100002.2"></a>Główne katalogi <span class="TEX">T<span +class="E">E</span>X</span> Live</h4> +<!--l. 278--><p class="noindent" >Poniżej wymieniono ważniejsze podkatalogi głównego katalogu <span +class="ec-lmri-10">instalacji </span><span class="TEX">T<span +class="E">E</span>X</span> Live (na płytce +<span class="TEX">T<span +class="E">E</span>X</span> Collection DVD cała dystrybucja <span class="TEX">T<span +class="E">E</span>X</span> Live została umieszczona w katalogu <span +class="ec-lmtt-10">texlive</span>, którego struktura +nieco się różni, nie zaś w katalogu głównym; poniżej traktujemy katalog <span +class="ec-lmtt-10">texlive </span>jako katalog główny we +wszystkich odniesieniach do <span class="TEX">T<span +class="E">E</span>X</span> Live). +<!--l. 284--><p class="noindent" > + <dl class="list1"><dt class="list"> + <span +class="ec-lmtt-10">bin</span> </dt><dd +class="list"> + <!--l. 285--><p class="noindent" >skompilowane programy <span class="TEX">T<span +class="E">E</span>X</span>-owe, zorganizowane w podkatalogach według platform + systemowych; + </dd><dt class="list"> + <span +class="ec-lmtt-10">readme-*.html</span> </dt><dd +class="list"> + <!--l. 288--><p class="noindent" >krótkie omówienie z użytecznymi odnośnikami, w kilku językach, w formacie HTML i zwykłym + tekstowym; + </dd><dt class="list"> + <span +class="ec-lmtt-10">source</span> </dt><dd +class="list"> + <!--l. 291--><p class="noindent" >źródła wszystkich programów, włącznie z głównymi dystrybucjami Web2C <span class="TEX">T<span +class="E">E</span>X</span>-a; + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf</span> </dt><dd +class="list"> + <!--l. 300--><p class="noindent" >drzewo katalogów plików pomocniczych i dokumentacji dla <span +class="ec-lmri-10">program</span><span +class="ec-lmri-10">ów </span>(patrz: <span +class="ec-lmtt-10">TEXMFMAIN</span> + w następnej części); + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf-dist</span> </dt><dd +class="list"> + <!--l. 303--><p class="noindent" >główne drzewo katalogów formatów i pakietów (zawiera makra, fonty i dokumentacje; patrz: + <span +class="ec-lmtt-10">TEXMDIST </span>w następnej części); + </dd><dt class="list"> + <span +class="ec-lmtt-10">tlpkg</span> </dt><dd +class="list"> + <!--l. 309--><p class="noindent" >skrypty, programy i inne dane potrzebne do instalacji; katalog zawiera także „prywatne” dla <span class="TEX">T<span +class="E">E</span>X</span> + Live kopie oprogramowania 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 i PDF – PS_View dla Windows.</dd></dl> +<!--l. 317--><p class="indent" > Prócz podkatalogów wymienionych powyżej, katalog główny zawiera skrypty instalacyjne oraz pliki +<span +class="ec-lmtt-10">README</span>, w formacie tekstowym lub HTML, w kilku językach (również polskim). +<!--l. 323--><p class="indent" > Do znalezienia dokumentacji przydatne mogą być dowiązania zawarte w pliku <a +href="../../../../doc.html" >doc.html</a>, który znajdziemy +w głównym katalogu instalacji. Dokumentacje programów (man, info, także w formacie PDF) znajdują się +w katalogu <span +class="ec-lmtt-10">texmf/doc</span>, zaś dokumentacje pakietów makr, fontów i formatów w katalogu <span +class="ec-lmtt-10">texmf-dist/doc</span>. +W odszukaniu konkretnej dokumentacji w dowolnym z wymienionych katalogów mogą pomóc programy +<span +class="ec-lmss-10">texdoc </span>lub <span +class="ec-lmss-10">texdoctk</span>. +<!--l. 331--><p class="indent" > Niniejsza dokumentacja w kilku językach znajduje się na płytce <span class="TEX">T<span +class="E">E</span>X</span> CollectionDVD w podkatalogach +katalogu <span +class="ec-lmtt-10">texlive-doc</span>, zaś po instalacji w podkatalogach katalogu <span +class="ec-lmtt-10">texmf/doc/texlive</span>: + <ul class="itemize1"> + <li class="itemize">uproszczony chiński: <a +href="../../../../texmf/doc/texlive/texlive-zh-cn" >texmf/doc/texlive/texlive-zh-cn</a> + </li> + <li class="itemize">czeski/słowacki: <a +href="../../../../texmf/doc/texlive/texlive-cz" >texmf/doc/texlive/texlive-cz</a> + </li> + <li class="itemize">angielski: <a +href="../../../../texmf/doc/texlive/texlive-en" >texmf/doc/texlive/texlive-en</a> + </li> + <li class="itemize">francuski: <a +href="../../../../texmf/doc/texlive/texlive-fr" >texmf/doc/texlive/texlive-fr</a> + </li> + <li class="itemize">niemiecki: <a +href="../../../../texmf/doc/texlive/texlive-de" >texmf/doc/texlive/texlive-de</a> + </li> + <li class="itemize">polski: <a +href="../../../../texmf/doc/texlive/texlive-pl" >texmf/doc/texlive/texlive-pl</a> + + + </li> + <li class="itemize">rosyjski: <a +href="../../../../texmf/doc/texlive/texlive-ru" >texmf/doc/texlive/texlive-ru</a> + </li> + <li class="itemize">serbski: <a +href="../../../../texmf/doc/texlive/texlive-sr" >texmf/doc/texlive/texlive-sr</a> + </li> + <li class="itemize">włoski: <a +href="../../../../texmf/doc/texlive/texlive-it" >texmf/doc/texlive/texlive-it</a></li></ul> +<!--l. 346--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">2.3. </span> <a + id="x1-110002.3"></a>Predefiniowane drzewa katalogów texmf</h4> +<!--l. 349--><p class="noindent" >W tej części wymieniono wszystkie używane przez system, predefiniowane zmienne specyfikujące drzewa +katalogów texmf; omówiono też ich przeznaczenie. Uruchomiając polecenie <span +class="ec-lmtt-10">tlmgr conf</span>, wyświetlimy wartości +tych zmiennych, dzięki czemu łatwo ustalimy, które katalogi w naszej instalacji są przypisane do konkretnych +zmiennych. +<!--l. 355--><p class="indent" > Wszystkie drzewa katalogów, włącznie z prywatnymi katalogami użytkownika, powinny posiadać strukturę +zgodną z zaleceniami <span class="TEX">T<span +class="E">E</span>X</span> Directory Structure (TDS, <a +href="http://tug.org/tds" class="url" ><span +class="ec-lmtt-10">http://tug.org/tds</span></a>), konsekwentnie wraz z +mnóstwem podkatalogów. W przeciwnym wypadku potrzebne pliki mogą nie zostać odnalezione. W części +<a +href="#x1-380003.4.6">3.4.6<!--tex4ht:ref: sec:local-personal-macros --></a> (str. <a +href="#x1-380003.4.6">39<!--tex4ht:ref: sec:local-personal-macros --></a>) będzie to omówione dokładniej. +<!--l. 362--><p class="noindent" > + <dl class="list1"><dt class="list"> + <span +class="ec-lmtt-10">TEXMFMAIN</span> </dt><dd +class="list"> + <!--l. 363--><p class="noindent" >Drzewo katalogów zawierające podstawowe dla dystrybucji elementy systemu, jak skrypty i inne + pliki pomocnicze oraz dokumentację programów (nie zawiera zatem pakietów makr ani formatów). + </dd><dt class="list"> + <span +class="ec-lmtt-10">TEXMFDIST</span> </dt><dd +class="list"> + <!--l. 368--><p class="noindent" >Drzewo katalogów zawierające pakiety makr, fontów itp., drzewo to może być współdzielone + z dowolną dystybucją. + </dd><dt class="list"> + <span +class="ec-lmtt-10">TEXMFLOCAL</span> </dt><dd +class="list"> + <!--l. 371--><p class="noindent" >Drzewo katalogów, które administratorzy mogą wykorzystać do przechowywania lokalnych makr, + fontów itp., dostępnych dla wszystkich użytkowników serwera. + </dd><dt class="list"> + <span +class="ec-lmtt-10">TEXMFHOME</span> </dt><dd +class="list"> + <!--l. 374--><p class="noindent" >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 <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">$HOME</span></span></span> (w Windows <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">%USERPROFILE%</span></span></span>). + </dd><dt class="list"> + <span +class="ec-lmtt-10">TEXMFCONFIG</span> </dt><dd +class="list"> + <!--l. 377--><p class="noindent" >Lokalne drzewo katalogów wykorzystywane przez narzędzia <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">texconfig</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">updmap</span></span></span> oraz <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">fmtutil</span></span></span> do + przechowywania danych konfiguracyjnych (domyślnie w ramach <span +class="ec-lmtt-10">TEXMFHOME</span>). + </dd><dt class="list"> + <span +class="ec-lmtt-10">TEXMFSYSCONFIG</span> </dt><dd +class="list"> + <!--l. 380--><p class="noindent" >Drzewo katalogów wykorzystywane przez narzędzia <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">texconfig-sys</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">updmap-sys</span></span></span> oraz + <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">fmtutil-sys</span></span></span> do przechowywania danych konfiguracyjnych dla całej instalacji (np. sieciowej). + </dd><dt class="list"> + <span +class="ec-lmtt-10">TEXMFVAR</span> </dt><dd +class="list"> + <!--l. 384--><p class="noindent" >Lokalne drzewo katalogów wykorzystywane przez <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">texconfig</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">updmap</span></span></span> i <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">fmtutil</span></span></span> do + przechowywania wygenerowanych plików formatów i map fontowych (domyślnie w ramach + <span +class="ec-lmtt-10">TEXMFHOME</span>). + </dd><dt class="list"> + <span +class="ec-lmtt-10">TEXMFCACHE</span> </dt><dd +class="list"> + <!--l. 387--><p class="noindent" >Drzewa katalogów wykorzystywane przez Con<span class="TEX">T<span +class="E">E</span>X</span>t MkIV do przechowywania buforowanych + danych z przetwarzania. + + + </dd><dt class="list"> + <span +class="ec-lmtt-10">TEXMFSYSVAR</span> </dt><dd +class="list"> + <!--l. 392--><p class="noindent" >Drzewo katalogów wykorzystywane przez <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">texconfig-sys</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">updmap-sys</span></span></span>, <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">fmtutil-sys</span></span></span>, a także + przez program <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">tlmgr</span></span></span> do przechowywania wygenerowanych plików formatów i map fontowych dla + całej instalacji.</dd></dl> +<!--l. 398--><p class="noindent" >Domyślny układ katalogów: + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">og</span><span +class="ec-lmbx-10">ólnosystemowy katalog instalacji</span> </dt><dd +class="description">może zawierać kilka wydań <span class="TEX">T<span +class="E">E</span>X</span> Live: + <dl class="list2"><dt class="list"> + <span +class="ec-lmtt-10">2011</span> </dt><dd +class="list"> + <!--l. 403--><p class="noindent" >poprzednie wydanie, + </dd><dt class="list"> + <span +class="ec-lmtt-10">2012</span> </dt><dd +class="list"> + <!--l. 404--><p class="noindent" >wydanie aktualne: + <dl class="list3"><dt class="list"> + <span +class="ec-lmtt-10">bin</span> </dt><dd +class="list"> + <!--l. 406--><p class="noindent" >  + <dl class="list4"><dt class="list"> + <span +class="ec-lmtt-10">i386-linux</span> </dt><dd +class="list"> + <!--l. 408--><p class="noindent" >programy dla GNU/Linux + </dd><dt class="list"> + <span +class="ec-lmtt-10">...</span> </dt><dd +class="list"> + <!--l. 409--><p class="noindent" > + </dd><dt class="list"> + <span +class="ec-lmtt-10">universal-darwin</span> </dt><dd +class="list"> + <!--l. 410--><p class="noindent" >programy dla Mac OS X + </dd><dt class="list"> + <span +class="ec-lmtt-10">win32</span> </dt><dd +class="list"> + <!--l. 411--><p class="noindent" >programy dla Windows</dd></dl> + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span> </dt><dd +class="list"> + <!--l. 413--><p class="noindent" >określany zmienną <span +class="ec-lmtt-10">TEXMFMAIN</span> + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf-dist</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span> </dt><dd +class="list"> + <!--l. 414--><p class="noindent" ><span +class="ec-lmtt-10">TEXMFDIST</span> + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf-var</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span> </dt><dd +class="list"> + <!--l. 415--><p class="noindent" ><span +class="ec-lmtt-10">TEXMFSYSVAR</span> + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf-config</span> </dt><dd +class="list"> + <!--l. 416--><p class="noindent" ><span +class="ec-lmtt-10">TEXMFSYSCONFIG</span></dd></dl> + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf-local</span> </dt><dd +class="list"> + <!--l. 418--><p class="noindent" ><span +class="ec-lmtt-10">TEXMFLOCAL</span>, katalog zachowywany od wydania do wydania,</dd></dl> + </dd><dt class="description"> +<span +class="ec-lmbx-10">katalog domowy u</span><span +class="ec-lmbx-10">żytkownika</span> </dt><dd +class="description">(<span +class="ec-lmtt-10">$HOME </span>lub <span +class="ec-lmtt-10">%USERPROFILE%</span>) + <dl class="list2"><dt class="list"> + <span +class="ec-lmtt-10">.texlive2011</span> </dt><dd +class="list"> + <!--l. 424--><p class="noindent" >prywatne pliki konfiguracyjne poprzedniego wydania + </dd><dt class="list"> + <span +class="ec-lmtt-10">.texlive2012</span> </dt><dd +class="list"> + <!--l. 426--><p class="noindent" >prywatne pliki konfiguracyjne dla bieżącego wydania: + <dl class="list3"><dt class="list"> + <span +class="ec-lmtt-10">texmf-var</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span> </dt><dd +class="list"> + <!--l. 429--><p class="noindent" ><span +class="ec-lmtt-10">TEXMFVAR</span>, <span +class="ec-lmtt-10">TEXMFCACHE</span> + + + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf-config</span> </dt><dd +class="list"> + <!--l. 430--><p class="noindent" ><span +class="ec-lmtt-10">TEXMFCONFIG</span></dd></dl> + </dd><dt class="list"> + <span +class="ec-lmtt-10">texmf</span> </dt><dd +class="list"> + <!--l. 432--><p class="noindent" ><span +class="ec-lmtt-10">TEXMFHOME </span>prywatne makra, fonty itp.</dd></dl> + </dd></dl> +<!--l. 436--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">2.4. </span> <a + id="x1-120002.4"></a>Rozszerzenia <span class="TEX">T<span +class="E">E</span>X</span>-a</h4> +<!--l. 439--><p class="noindent" >Oryginalny <span class="TEX">T<span +class="E">E</span>X</span>, stworzony przez prof. Knutha, został zamrożony, ale jest i będzie w przyszłości +dostępny w dystrybucji. <span class="TEX">T<span +class="E">E</span>X</span> Live zawiera ponadto kilka wersji rozszerzonych standardowego +<span class="TEX">T<span +class="E">E</span>X</span>-a: +<!--l. 443--><p class="indent" > + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">e-</span><span class="TEX"><span +class="ec-lmbx-10">T</span><span +class="E"><span +class="ec-lmbx-10">E</span></span><span +class="ec-lmbx-10">X</span></span> </dt><dd +class="description">wersja programu <span class="TEX">T<span +class="E">E</span>X</span>, w której dodano pożyteczny zestaw nowych poleceń wbudowanych + (dotyczących głównie rozwijania makr, leksemów znakowych, interpretacji znaczników itp.) + oraz rozszerzenie <span class="TEX">T<span +class="E">E</span>X</span>--XE T dla składu od prawej do lewej. W trybie domyślnym e-<span class="TEX">T<span +class="E">E</span>X</span> + jest w 100% zgodny ze standardowym programem <span class="TEX">T<span +class="E">E</span>X</span>. Więcej szczegółów można znaleźć + w <a +href="../../../../texmf-dist/doc/etex/base/etex_man.pdf" >texmf-dist/doc/etex/base/etex_man.pdf</a>. + </dd><dt class="description"> +<span +class="ec-lmbx-10">pdf</span><span class="TEX"><span +class="ec-lmbx-10">T</span><span +class="E"><span +class="ec-lmbx-10">E</span></span><span +class="ec-lmbx-10">X</span></span> </dt><dd +class="description">program zawierający silnik e-<span class="TEX">T<span +class="E">E</span>X</span> i dalsze rozszerzenia, który umożliwia 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 <span class="TEX">T<span +class="E">E</span>X</span>), nie ma więc obecnie rozróżnienia na „maszyny” <span +class="ec-lmss-10">pdftex </span>i <span +class="ec-lmss-10">pdfetex</span>, jak to + miało miejsce w poprzednich wersjach programów i w poprzednich dystrybucjach <span class="TEX">T<span +class="E">E</span>X</span> Live. + Podręczniki znajdziemy w katalogu <a +href="../../../../texmf-dist/doc/pdftex/manual/pdftex-a.pdf" >texmf-dist/doc/pdftex/manual/pdftex-a.pdf</a>, zaś przykład + wykorzystania w pliku <a +href="../../../../texmf-dist/doc/pdftex/manual/samplepdf/samplepdf.tex" >texmf-dist/doc/pdftex/manual/samplepdf/samplepdf.tex</a>. + </dd><dt class="description"> +<span +class="ec-lmbx-10">Lua</span><span class="TEX"><span +class="ec-lmbx-10">T</span><span +class="E"><span +class="ec-lmbx-10">E</span></span><span +class="ec-lmbx-10">X</span></span> </dt><dd +class="description">docelowo sukcesor pdf<span class="TEX">T<span +class="E">E</span>X</span>-a, z którym ma być, aczkolwiek niecałkowicie, zgodny + wstecz. Powinien także zastąpić Aleph (patrz niżej), choć nie zakłada się tu technicznej + kompatybilności. Załączony interpreter Lua (patrz strona domowa <a +href="http://www.lua.org/" class="url" ><span +class="ec-lmtt-10">http://www.lua.org/</span></a>) + pozwala na eleganckie rozwiązanie wielu trudnych problemów <span class="TEX">T<span +class="E">E</span>X</span>-a. Program <span +class="ec-lmtt-10">texlua </span>ma + funkcjonalność samodzielnego interpretera Lua, co sprawia, że jest używany w <span class="TEX">T<span +class="E">E</span>X</span> Live do + wielu zadań. Patrz <a +href="http://www.luatex.org/" class="url" ><span +class="ec-lmtt-10">http://www.luatex.org/</span></a> i na DVD <a +href="../../../../texmf-dist/doc/luatex/luatexref-t.pdf" >texmf-dist/doc/luatex/luatexref-t.pdf</a>. + </dd><dt class="description"> +<span +class="ec-lmbx-10">Xe</span><span class="TEX"><span +class="ec-lmbx-10">T</span><span +class="E"><span +class="ec-lmbx-10">E</span></span><span +class="ec-lmbx-10">X</span></span> </dt><dd +class="description">umożliwia kodowanie tekstów w Unicode oraz korzystanie z fontów OpenType (także tych + dostępnych bezpośrednio w systemie operacyjnym), przy czym stosuje biblioteki obce. Patrz + <a +href="http://tug.org/xetex" class="url" ><span +class="ec-lmtt-10">http://tug.org/xetex</span></a>. + </dd><dt class="description"> +<span +class="ec-lmbx-10">Omega (Omega)</span> </dt><dd +class="description">program, który pracuje wewnętrznie ze znakami kodowanymi 16-bitowo (Unicode), + pozwalając składać jednocześnie większość tekstów spotykanych na świecie. Wspomaga + dynamicznie ładowane tzw. „procesy tłumaczenia Omega” (OTP), co pozwala użytkownikowi + definiować złożone transformacje, wykonywane na dowolnych strumieniach wejściowych. Sam + program od dawna nie jest aktualizowany, został więc usunięty z <span class="TEX">T<span +class="E">E</span>X</span> Live. Pozostawiono jego + działający klon: + </dd><dt class="description"> +<span +class="ec-lmbx-10">Aleph</span> </dt><dd +class="description">łączy rozszerzenia Omega i e-<span class="TEX">T<span +class="E">E</span>X</span>; powstał jako niezależny projekt z potrzeby stabilnej + „używalności” programu Omega, w sytuacji, gdy ten pozostawał wciąż w fazie eksperymentalnej. + Dostępna jest minimalna dokumentacja: <a +href="../../../../texmf-dist/doc/aleph/base" >texmf-dist/doc/aleph/base</a>. + </dd></dl> + + +<!--l. 494--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">2.5. </span> <a + id="x1-130002.5"></a>Inne ważniejsze programy <span class="TEX">T<span +class="E">E</span>X</span> Live</h4> +<!--l. 496--><p class="noindent" >Poniżej zestawiono kilka innych, najczęściej używanych programów, dostępnych w dystrybucji <span class="TEX">T<span +class="E">E</span>X</span> +Live: +<!--l. 499--><p class="indent" > + <dl class="list1"><dt class="list"> + <span +class="ec-lmss-10">bibtex, bibtex8</span> </dt><dd +class="list"> + <!--l. 501--><p class="noindent" >tworzenie spisów bibliograficznych; + </dd><dt class="list"> + <span +class="ec-lmss-10">makeindex, xindy</span> </dt><dd +class="list"> + <!--l. 503--><p class="noindent" >tworzenie posortowanych skorowidzów; + </dd><dt class="list"> + <span +class="ec-lmss-10">dvips</span> </dt><dd +class="list"> + <!--l. 505--><p class="noindent" >konwersja DVI do PostScript; + </dd><dt class="list"> + <span +class="ec-lmss-10">xdvi</span> </dt><dd +class="list"> + <!--l. 507--><p class="noindent" >przeglądarka plików DVI dla X Window; + </dd><dt class="list"> + <span +class="ec-lmss-10">dvilj</span> </dt><dd +class="list"> + <!--l. 509--><p class="noindent" >sterownik dla drukarek HP LaserJet; + </dd><dt class="list"> + <span +class="ec-lmss-10">dviconcat, dviselect</span> </dt><dd +class="list"> + <!--l. 513--><p class="noindent" >programy do manipulacji stronami w plikach DVI; + </dd><dt class="list"> + <span +class="ec-lmss-10">dvipdfmx</span> </dt><dd +class="list"> + <!--l. 516--><p class="noindent" >konwersja DVI do PDF, metoda alternatywna w stosunku do wspomnianego wyżej programu + pdf<span class="TEX">T<span +class="E">E</span>X</span>; + </dd><dt class="list"> + <span +class="ec-lmss-10">psselect, psnup, </span><span +class="ec-lmss-10">…</span> </dt><dd +class="list"> + <!--l. 521--><p class="noindent" >narzędzia do manipulacji na plikach postscriptowych; + </dd><dt class="list"> + <span +class="ec-lmss-10">pdfjam, pdfjoin, </span><span +class="ec-lmss-10">…</span> </dt><dd +class="list"> + <!--l. 524--><p class="noindent" >narzędzia do manipulacji na plikach PDF; + </dd><dt class="list"> + <span +class="ec-lmss-10">texexec, texmfstart</span> </dt><dd +class="list"> + <!--l. 529--><p class="noindent" >programy uruchamiające dla Con<span class="TEX">T<span +class="E">E</span>X</span>t; + </dd><dt class="list"> + <span +class="ec-lmss-10">tex4ht</span> </dt><dd +class="list"> + <!--l. 531--><p class="noindent" >postprocesor dla <span class="TEX">T<span +class="E">E</span>X</span>-a konwersji do HTML i XML. + </dd></dl> +<!--l. 538--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">2.6. </span> <a + id="x1-140002.6"></a>Pakiety i ich zestawy</h4> +<!--l. 540--><p class="noindent" >Zawartość drzew <span +class="ec-lmtt-10">texmf </span>na <span class="TEX">T<span +class="E">E</span>X</span> Live została do celów instalacji zorganizowana w szereg „zestawów” +(<span +class="ec-lmri-10">collections</span>), z których każdy posiada zbiór „pakietów” (<span +class="ec-lmri-10">packages</span>; jest ich obecnie ponad 2500). +Normalna instalacja pozwala użytkownikowi skopiować z DVD na twardy dysk jeden lub więcej +zestawów, ale można też doinstalować z niej do już zainstalowanego zestawu jedynie pojedynczy +pakiet. + + +<!--l. 547--><p class="indent" > Zestawy pozwalają lepiej dobrać instalowane składniki, a także określić, jakie języki będą obsługiwane po +instalacji. Najważniejszy zestaw, wymagany dla większości zastosowań, to „Essential programs and files”. +Zestawy „Basic LaTeX packages” i „Recommended fonts” są rekomendowane dla większości użytkowników. +Pozostałe zestawy są opcjonalne. +<!--l. 553--><p class="indent" > Oto wybrane dostępne zestawy i krótki opis ich zawartości: +<!--l. 555--><p class="indent" > + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">Essential programs and files</span> </dt><dd +class="description">podstawowe programy, pakiety makr i fontów systemu <span class="TEX">T<span +class="E">E</span>X</span>, pliki + konfiguracyjne dla podstawowych sterowników; + </dd><dt class="description"> +<span +class="ec-lmbx-10">Extra BibTeX styles</span> </dt><dd +class="description">dodatkowa, obszerna biblioteka stylów Bib<span class="TEX">T<span +class="E">E</span>X</span>-owych i bazy danych + bibliograficznych (podstawowe style znajdują się w zestawie „Essential…”); + </dd><dt class="description"> +<span +class="ec-lmbx-10">Context format</span> </dt><dd +class="description">pakiet makr do Con<span class="TEX">T<span +class="E">E</span>X</span>t – „dialektu” <span class="TEX">T<span +class="E">E</span>X</span>-a autorstwa Hansa Hagena; + </dd><dt class="description"> +<span +class="ec-lmbx-10">TeX auxiliary programs</span> </dt><dd +class="description">różne programy pomocnicze; zestaw zawiera m.in. programy i makra dla + systemu texinfo, programy do manipulacji na plikach DVI itp.; + </dd><dt class="description"> +<span +class="ec-lmbx-10">TeX and Outline font utilities</span> </dt><dd +class="description">programy do konwersji plików fontowych oraz testowania i instalacji + fontów (zestaw do tworzenia fontów wirtualnych, manipulacji plikami .gf i .pk, programy <span +class="ec-lmtt-10">mft</span>, + <span +class="ec-lmtt-10">fontinst </span>itp.); + </dd><dt class="description"> +<span +class="ec-lmbx-10">Recommended fonts</span> </dt><dd +class="description">obszerna biblioteka częściej używanych fontów w postaci źródłowej (.mf) bądź + fontów obwiedniowych oraz pliki z definicjami i stylami <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>-a dla tych fontów; + </dd><dt class="description"> +<span +class="ec-lmbx-10">Extra fonts</span> </dt><dd +class="description">biblioteka różnych rzadziej używanych fontów; + </dd><dt class="description"> +<span +class="ec-lmbx-10">Extra formats</span> </dt><dd +class="description">pliki pomocnicze do generowania dodatkowych „formatów” (tj. obszerne zestawy makr + służące do wstępnego przetworzenia i utworzenia pliku <span +class="ec-lmtt-10">.fmt</span>); + </dd><dt class="description"> +<span +class="ec-lmbx-10">Games typesetting</span> </dt><dd +class="description">pakiety do prezentacji zapisu różnych gier (szachy, brydż itp.); + </dd><dt class="description"> +<span +class="ec-lmbx-10">Extra generic packages</span> </dt><dd +class="description">obszerna biblioteka makr, trudnych do sklasyfikowania, działających + z różnymi formatami (Plain, <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> itp.); + </dd><dt class="description"> +<span +class="ec-lmbx-10">HTML/SGML/XML support</span> </dt><dd +class="description">pakiety konwersji <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>-a do XML/HTML oraz do składu + dokumentów XML/SGML; + </dd><dt class="description"> +<span +class="ec-lmbx-10">lang</span><span +class="ec-lmbx-10">…</span> </dt><dd +class="description">wsparcie poszczególnych języków; zestawy zawierają wzorce przenoszenia wyrazów i makra + obsługi danych języków, czasem też specyficzne fonty itp., przykładowo: + </dd><dt class="description"> +<span +class="ec-lmbx-10">langpolish</span> </dt><dd +class="description">zawiera polskie pakiety: makra do tworzenia formatu MeX, pakiety <span +class="ec-lmtt-10">polski</span>, <span +class="ec-lmtt-10">mwcls</span>, fonty + i makra dodatkowe przydatne dla polskich użytkowników oraz dokumentacje w języku polskim.</dd></dl> +<!--l. 633--><p class="indent" > <hr class="figure"><div class="figure" +> + + +<a + id="x1-14061r1"></a> + + +<div class="fancyvrb" id="fancyvrb1"><a + id="x1-14002r1"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Installing</span><span +class="ec-lmtt-8"> TeX</span><span +class="ec-lmtt-8"> Live</span><span +class="ec-lmtt-8"> 2012</span><span +class="ec-lmtt-8"> from:</span><span +class="ec-lmtt-8"> ...</span><br class="fancyvrb" /><a + id="x1-14004r2"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Platform:</span><span +class="ec-lmtt-8"> i386-linux</span><span +class="ec-lmtt-8"> =></span><span +class="ec-lmtt-8"> ’Intel</span><span +class="ec-lmtt-8"> x86</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> GNU/Linux’</span><br class="fancyvrb" /><a + id="x1-14006r3"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Distribution:</span><span +class="ec-lmtt-8"> inst</span><span +class="ec-lmtt-8"> (compressed)</span> +<br class="fancyvrb" /><a + id="x1-14008r4"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> ...</span><br class="fancyvrb" /><a + id="x1-14010r5"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Detected</span><span +class="ec-lmtt-8"> platform:</span><span +class="ec-lmtt-8"> Intel</span><span +class="ec-lmtt-8"> x86</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> GNU/Linux</span><br class="fancyvrb" /><a + id="x1-14012r6"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><br class="fancyvrb" /><a + id="x1-14014r7"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> <B></span><span +class="ec-lmtt-8"> platforms:</span><span +class="ec-lmtt-8"> 1</span><span +class="ec-lmtt-8"> out</span><span +class="ec-lmtt-8"> of</span><span +class="ec-lmtt-8"> 19</span><br class="fancyvrb" /><a + id="x1-14016r8"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><br class="fancyvrb" /><a + id="x1-14018r9"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> <S></span><span +class="ec-lmtt-8"> Installation</span><span +class="ec-lmtt-8"> scheme</span><span +class="ec-lmtt-8"> (scheme-full)</span> +<br class="fancyvrb" /><a + id="x1-14020r10"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> 84</span><span +class="ec-lmtt-8"> collections</span><span +class="ec-lmtt-8"> out</span><span +class="ec-lmtt-8"> of</span><span +class="ec-lmtt-8"> 85,</span><span +class="ec-lmtt-8"> disk</span><span +class="ec-lmtt-8"> space</span><span +class="ec-lmtt-8"> required:</span><span +class="ec-lmtt-8"> 3091</span><span +class="ec-lmtt-8"> MB</span><br class="fancyvrb" /><a + id="x1-14022r11"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><br class="fancyvrb" /><a + id="x1-14024r12"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Customizing</span><span +class="ec-lmtt-8"> installation</span><span +class="ec-lmtt-8"> scheme:</span> +<br class="fancyvrb" /><a + id="x1-14026r13"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> <C></span><span +class="ec-lmtt-8"> standard</span><span +class="ec-lmtt-8"> collections</span><br class="fancyvrb" /><a + id="x1-14028r14"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> <L></span><span +class="ec-lmtt-8"> language</span><span +class="ec-lmtt-8"> collections</span><br class="fancyvrb" /><a + id="x1-14030r15"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><br class="fancyvrb" /><a + id="x1-14032r16"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> <D></span><span +class="ec-lmtt-8"> directories:</span><br class="fancyvrb" /><a + id="x1-14034r17"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> TEXDIR</span><span +class="ec-lmtt-8"> (the</span><span +class="ec-lmtt-8"> main</span><span +class="ec-lmtt-8"> TeX</span><span +class="ec-lmtt-8"> directory):</span> +<br class="fancyvrb" /><a + id="x1-14036r18"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> /usr/local/texlive/2012</span><br class="fancyvrb" /><a + id="x1-14038r19"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> ...</span><br class="fancyvrb" /><a + id="x1-14040r20"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><br class="fancyvrb" /><a + id="x1-14042r21"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> <O></span><span +class="ec-lmtt-8"> options:</span><br class="fancyvrb" /><a + id="x1-14044r22"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> use</span><span +class="ec-lmtt-8"> letter</span><span +class="ec-lmtt-8"> size</span><span +class="ec-lmtt-8"> instead</span><span +class="ec-lmtt-8"> of</span><span +class="ec-lmtt-8"> A4</span><span +class="ec-lmtt-8"> by</span><span +class="ec-lmtt-8"> default</span><br class="fancyvrb" /><a + id="x1-14046r23"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> ...</span><br class="fancyvrb" /><a + id="x1-14048r24"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span> +<br class="fancyvrb" /><a + id="x1-14050r25"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> <V></span><span +class="ec-lmtt-8"> set</span><span +class="ec-lmtt-8"> up</span><span +class="ec-lmtt-8"> for</span><span +class="ec-lmtt-8"> portable</span><span +class="ec-lmtt-8"> installation</span><br class="fancyvrb" /><a + id="x1-14052r26"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><br class="fancyvrb" /><a + id="x1-14054r27"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Actions:</span><br class="fancyvrb" /><a + id="x1-14056r28"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> <I></span><span +class="ec-lmtt-8"> start</span><span +class="ec-lmtt-8"> installation</span><span +class="ec-lmtt-8"> to</span><span +class="ec-lmtt-8"> hard</span><span +class="ec-lmtt-8"> disk</span><br class="fancyvrb" /><a + id="x1-14058r29"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> <H></span><span +class="ec-lmtt-8"> help</span><br class="fancyvrb" /><a + id="x1-14060r30"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> <Q></span><span +class="ec-lmtt-8"> quit</span></div> +<br /> <div class="caption" +><span class="id">Rysunek 1: </span><span +class="content">Główny ekran instalatora w trybie tekstowym (GNU/Linux)</span></div><!--tex4ht:label?: x1-14061r1 --> + + +<!--l. 668--><p class="indent" > </div><hr class="endfigure"> +<!--l. 670--><p class="indent" > Plik <span +class="ec-lmtt-10">tlpdb/texlive.tlpdb </span>(wykorzystywany podczas instalacji) zawiera spis wszystkich plików w każdym +pakiecie. + <h4 class="subsectionHead"><span class="titlemark">2.7. </span> <a + id="x1-150002.7"></a>Fonty w <span class="TEX">T<span +class="E">E</span>X</span> Live</h4> +<!--l. 676--><p class="noindent" ><span class="TEX">T<span +class="E">E</span>X</span> Live zawiera wiele wysokiej jakości fontów skalowanych. Patrz: <a +href="http://tug.org/fonts" class="url" ><span +class="ec-lmtt-10">http://tug.org/fonts</span></a> oraz +<a +href="../../../../texmf-dist/doc/fonts/free-math-fonts-survey" >texmf-dist/doc/fonts/free-math-fonts-survey</a>. +<!--l. 682--><p class="indent" > <a id="installation"></a> + <h3 class="sectionHead"><span class="titlemark">3. </span> <a + id="x1-160003"></a>Instalacja</h3> +<!--l. 686--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">3.1. </span> <a + id="x1-170003.1"></a>Start instalacji</h4> +<!--l. 689--><p class="noindent" >Instalację <span class="TEX">T<span +class="E">E</span>X</span> Live uruchamiamy z płytki <span class="TEX">T<span +class="E">E</span>X</span> Collection DVD (bądź po pobraniu z sieci +pakietu instalacyjnego i jego rozpakowaniu) skryptem <span +class="ec-lmtt-10">install-tl </span>(Unix), <span +class="ec-lmtt-10">install-tl.bat </span>lub +<span +class="ec-lmtt-10">install-tl-advanced.bat </span>(Windows). Dodatkowe informacje na temat różnych metod instalacji znajdziemy +na stronie <a +href="http://tug.org/texlive/acquire.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/acquire.html</span></a>. +<!--l. 695--><p class="indent" > + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">Instalacja z sieci:</span> </dt><dd +class="description">z archiwum CTAN, z katalogu + <span +class="ec-lmtt-10">systems/texlive/tlnet </span>(<a +href="http://mirror.ctan.org/systems/texlive/tlnet" class="url" ><span +class="ec-lmtt-10">http://mirror.ctan.org/systems/texlive/tlnet</span></a> automatycznie + przekierowuje do najbliższej kopii CTAN) należy pobrać plik <span +class="ec-lmtt-10">install-tl.zip </span>(wspólny dla + Unix i Windows) lub znacznie mniejszy <span +class="ec-lmtt-10">install-unx.tar.gz </span>(tylko dla Unix). Po rozpakowaniu, + w katalogu <span +class="ec-lmtt-10">install-tl/ </span>znajdziemy skrypty instalacyjne <span +class="ec-lmtt-10">install-tl</span>, <span +class="ec-lmtt-10">install-tl.bat</span> + i <span +class="ec-lmtt-10">install-tl-advanced.bat</span>. + </dd><dt class="description"> +<span +class="ec-lmbx-10">Instalacja z płytki </span><span class="TEX"><span +class="ec-lmbx-10">T</span><span +class="E"><span +class="ec-lmbx-10">E</span></span><span +class="ec-lmbx-10">X</span></span> <span +class="ec-lmbx-10">Collection DVD:</span> </dt><dd +class="description">po zamontowaniu płytki należy zmienić katalog + bieżący na <span +class="ec-lmtt-10">texlive </span>DVD (w Windows program instalacyjny powinien uruchomić się + automatycznie). DVD otrzymamy w ramach członkostwa w dowolnej Grupie Użytkowników + Systemu <span class="TEX">T<span +class="E">E</span>X</span> (kontakt w Polsce <a +href="http://www.gust.org.pl" class="url" ><span +class="ec-lmtt-10">http://www.gust.org.pl</span></a>). Możemy także wypalić płytkę z + dostępnego w sieci jej obrazu ISO bądź zamontować bezpośrednio plik obrazu (w większości + systemów istnieje taka możliwość). Po zainstalowaniu z DVD lub obrazu ISO można dokonywać + aktualizacji z internetu (patrz <a +href="#x1-350003.4.3">3.4.3<!--tex4ht:ref: sec:dvd-install-net-updates --></a>).</dd></dl> +<!--l. 717--><p class="indent" > Bez względu na źródło stosowany jest ten sam program instalacyjny. Jedyną widoczną różnicą przy +instalacji z sieci jest pobranie zaktualizowanych pakietów, w przeciwieństwie do DVD i obrazu ISO, które nie +są aktualizowane między corocznymi wydaniami. +<!--l. 722--><p class="indent" > Dalsze kroki omówiono dokładniej poniżej. +<!--l. 725--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.1.1. </span> <a + id="x1-180003.1.1"></a>Unix</h5> +<!--l. 727--><p class="noindent" >Poniżej <span +class="ec-lmtt-10">> </span>oznacza znak zachęty systemu (tzw. prompt); to, co wpisuje użytkownik, zaznaczono <span +class="ec-lmtk-10">pogrubieniem</span>. +W oknie terminala należy wykonać: <div class="alltt"> +<!--l. 731--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">cd</span><span +class="ec-lmtk-10"> /path/to/installer</span> +<br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">perl</span><span +class="ec-lmtk-10"> install-tl</span> +</div> +</div> (można także uruchomić <span +class="ec-lmtk-10">perl /path/to/installer/install-tl </span>lub <span +class="ec-lmtk-10">./install-tl</span>; w dalszej części nie +będziemy powtarzać wszelkich możliwych kombinacji). Zalecane jest powiększenie okna terminala, aby +zobaczyć pełną zawartość ekranu programu instalacyjnego (rys. <a +href="#x1-14061r1">1<!--tex4ht:ref: fig:text-main --></a>). + + +<!--l. 741--><p class="indent" > Do uruchomienia w trybie graficznym (GUI; rys. <a +href="#x1-18001r2">2<!--tex4ht:ref: fig:gui-main --></a>) wymagana jest obecność w systemie modułu <span +class="ec-lmtt-10">Perl/TK</span> +skompilowanego ze wsparciem dla XFT (w systemach GNU/Linux jest on z reguły dostępny, ale dla innych +systemów niekoniecznie): <div class="alltt"> +<!--l. 745--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">perl</span><span +class="ec-lmtk-10"> install-tl</span><span +class="ec-lmtk-10"> -gui</span> +</div> +</div> +<!--l. 749--><p class="indent" > Kompletny wykaz dostępnych opcji otrzymamy uruchamiając: <div class="alltt"> +<!--l. 750--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">perl</span><span +class="ec-lmtk-10"> install-tl</span><span +class="ec-lmtk-10"> -help</span> +</div> +</div> +<!--l. 754--><p class="indent" > <span +class="ec-lmbx-10">Uwaga dotycząca uprawnie</span><span +class="ec-lmbx-10">ń w Unix: </span>program instalacyjny będzie respektował aktualną wartość +<span +class="ec-lmtt-10">umask</span>. Jeśli więc chcemy, aby instalacja była dostępna dla innych użytkowników, musimy ustawić wartość np. +<span +class="ec-lmtt-10">umask 002</span>. Więcej informacji na temat <span +class="ec-lmtt-10">umask </span>znajdziemy w dokumentacji posiadanego systemu +operacyjnego. +<!--l. 760--><p class="indent" > <hr class="figure"><div class="figure" +> + + +<a + id="x1-18001r2"></a> + + + +<!--l. 761--><p class="noindent" ><img +src="../texlive-common/install-lnx-main.png" alt="pict" +> +<br /> <div class="caption" +><span class="id">Rysunek 2: </span><span +class="content">Ekran zaawansowanego programu instalacyjnego GUI (GNU/Linux)</span></div><!--tex4ht:label?: x1-18001r2 --> + + +<!--l. 764--><p class="indent" > </div><hr class="endfigure"> +<!--l. 766--><p class="indent" > <span +class="ec-lmbx-10">Uwagi specjalne dotyczące Cygwin: </span>w odróżnieniu od wielu rzeczywistych systemów +operacyjnych, których Cygwin jest jedynie emulatorem, w środowisku tym mogą nie być domyślnie +zainstalowane niektóre programy wymagane dla instalatora <span class="TEX">T<span +class="E">E</span>X</span> Live. Dodatkowe informacje – patrz +część <a +href="#x1-210003.1.4">3.1.4<!--tex4ht:ref: sec:cygwin --></a>. + <h5 class="subsubsectionHead"><span class="titlemark">3.1.2. </span> <a + id="x1-190003.1.2"></a>MacOSX</h5> +<!--l. 774--><p class="noindent" >Jak wspomniano w części <a +href="#x1-90002.1">2.1<!--tex4ht:ref: sec:tl-coll-dists --></a>, dla Mac OS X przygotowano odrębną dystrybucję Mac<span class="TEX">T<span +class="E">E</span>X</span> (<a +href="http://tug.org/mactex" class="url" ><span +class="ec-lmtt-10">http://tug.org/mactex</span></a>). +W jej wypadku należy użyć dedykowanego programu instalacyjnego, gdyż zmienia on w specyficzny sposób +ustawienia systemu, w szczególności pozwala na łatwe przełączanie między różnymi dystrybucjami <span class="TEX">T<span +class="E">E</span>X</span>-a dla +Mac OS X: Mac<span class="TEX">T<span +class="E">E</span>X</span>, Fink, MacPorts. +<!--l. 781--><p class="indent" > Mac<span class="TEX">T<span +class="E">E</span>X</span> jest oparty na <span class="TEX">T<span +class="E">E</span>X</span> Live i główne drzewa katalogów pozostały w nim dokładnie +takie same, dodano jedynie katalogi ze specyficznymi dla systemu Mac OS X dokumentacjami +i aplikacjami. +<!--l. 785--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.1.3. </span> <a + id="x1-200003.1.3"></a>Windows</h5> +<!--l. 787--><p class="noindent" >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ć <span +class="ec-lmtt-10">install-tl.bat </span>(np. podwójnym kliknięciem myszy). Można to uczynić +także z linii poleceń. Gdy katalog zawierający ten plik jest katalogiem bieżącym, wystarczy uruchomić: +<div class="alltt"> +<!--l. 792--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">install-tl</span> +</div> +</div> bądź, dla bardziej wymagającej instalacji, pozwalającej na wybór schematów, kolekcji itp.: <div class="alltt"> +<!--l. 797--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">install-tl-advanced</span> +</div> +</div> +<!--l. 801--><p class="indent" > W linii poleceń można też podać ścieżkę do programu, np.: <div class="alltt"> +<!--l. 802--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">D:</span><span +class="ec-lmtt-10">\</span><span +class="ec-lmtk-10">texlive</span><span +class="ec-lmtt-10">\</span><span +class="ec-lmtk-10">install-tl</span> +</div> +</div> dla <span class="TEX">T<span +class="E">E</span>X</span> Collection DVD, zakładając, że <span +class="ec-lmtt-10">D: </span>jest napędem DVD (rys. <a +href="#x1-20001r3">3<!--tex4ht:ref: fig:wizard-w32 --></a> pokazuje domyślny dla Windows +ekran programu instalacyjnego). +<!--l. 809--><p class="indent" > Instalacja w trybie tekstowym wymaga podania: <div class="alltt"> +<!--l. 810--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">install-tl</span><span +class="ec-lmtk-10"> -no-gui</span> +</div> +</div> +<!--l. 814--><p class="indent" > Wszystkie dostępne opcje wyświetlimy uruchamiając: <div class="alltt"> +<!--l. 815--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">install-tl</span><span +class="ec-lmtk-10"> -help</span> +</div> +</div> +<!--l. 819--><p class="indent" > <hr class="figure"><div class="figure" +> + + +<a + id="x1-20001r3"></a> + + + +<!--l. 820--><p class="noindent" ><img +src="../texlive-common/wizard-w32.png" alt="pict" +> +<br /> <div class="caption" +><span class="id">Rysunek 3: </span><span +class="content">Ekran programu instalacyjnego „Wizard” (Windows)</span></div><!--tex4ht:label?: x1-20001r3 --> + + +<!--l. 823--><p class="indent" > </div><hr class="endfigure"> +<!--l. 825--><p class="indent" > <a id="cygwin"></a> + <h5 class="subsubsectionHead"><span class="titlemark">3.1.4. </span> <a + id="x1-210003.1.4"></a>Cygwin</h5> +<!--l. 829--><p class="noindent" >Program instalujący <span class="TEX">T<span +class="E">E</span>X</span> Live obsługuje jedynie Cygwin w wersji 1.7. Przed instalacją w tym systemie zaleca +się uruchomić program <span +class="ec-lmtt-10">setup.exe </span>i, o ile nie zostały one uprzednio zainstalowane, zainstalować pakiety <span +class="ec-lmtt-10">perl</span> +oraz <span +class="ec-lmtt-10">wget</span>. Ponadto zalecana jest instalacja: + <ul class="itemize1"> + <li class="itemize"><span +class="ec-lmtt-10">fontconfig </span>(wymagany dla Xe<span class="TEX">T<span +class="E">E</span>X</span>) + </li> + <li class="itemize"><span +class="ec-lmtt-10">ghostscript </span>(wymagany dla wielu narzędzi) + </li> + <li class="itemize"><span +class="ec-lmtt-10">libXaw7 </span>(wymagany dla <span +class="ec-lmtt-10">xdvi</span>) + </li> + <li class="itemize"><span +class="ec-lmtt-10">ncurses </span>(udostępnia <span +class="ec-lmtt-10">clear </span>– „czyste” polecenie stosowane przez program instalacyjny)</li></ul> +<!--l. 842--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.1.5. </span> <a + id="x1-220003.1.5"></a>Instalator w trybie tekstowym</h5> +<!--l. 844--><p class="noindent" >Rysunek <a +href="#x1-14061r1">1<!--tex4ht:ref: fig:text-main --></a> przedstawia główny ekran programu <span +class="ec-lmtt-10">install-tl </span>w (domyślnym) trybie tekstowym w systemie +Unix. W tym trybie nie używamy ani klawiszy kursora, ani myszy, lecz wyłącznie klawiszy alfanumerycznych +(uwaga: duże i małe litery są rozróżniane!). Wybraną opcję zatwierdzamy klawiszem Enter. Instalator +w trybie tekstowym jest na tyle prosty, by działał na możliwie wielu platformach, nawet wyposażonych +jedynie w podstawowe biblioteki Perla. +<!--l. 853--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.1.6. </span> <a + id="x1-230003.1.6"></a>Zaawansowany program instalacyjny w trybie graficznym</h5> +<!--l. 855--><p class="noindent" >Rysunek <a +href="#x1-18001r2">2<!--tex4ht:ref: fig:gui-main --></a> przedstawia program instalacyjny w trybie graficznym, w wersji rozszerzonej. W systemie Windows +znajdziemy tu dodatkowe przyciski dla opcji nieistotnych w systemach Unix/Linux. Tryb ten uruchamiamy +poleceniem: + <div class="alltt"> +<!--l. 860--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10"> ></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">install-tl</span><span +class="ec-lmtk-10"> -gui=perltk</span> +</div> +</div> +<!--l. 864--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.1.7. </span> <a + id="x1-240003.1.7"></a>Uproszczony program instalacyjny</h5> +<!--l. 866--><p class="noindent" >W systemie Windows domyślnie uruchamiany jest uproszczony program instalujący wszystkie pakiety <span class="TEX">T<span +class="E">E</span>X</span> +Live, który wymaga od użytkownika odpowiedzi jedynie na kilka pytań (katalog docelowy itp.). Tryb ten, +zwany <span +class="ec-lmri-10">wizard </span>(„czarodziej”, „mag”, rys. <a +href="#x1-20001r3">3<!--tex4ht:ref: fig:wizard-w32 --></a>), uruchamiany jest poleceniem: + <div class="alltt"> +<!--l. 872--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">install-tl</span><span +class="ec-lmtk-10"> -gui=wizard</span> +</div> +</div> + + +<!--l. 876--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">3.2. </span> <a + id="x1-250003.2"></a>Podczas instalacji</h4> +<!--l. 879--><p class="noindent" >Program instalacyjny jest z założenia na tyle prosty, że szczegółowe wyjaśnienia wydają się zbędne. Podamy +jednak kilka uwag dotyczących różnych opcji i dostępnych podmenu. +<!--l. 883--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.2.1. </span> <a + id="x1-260003.2.1"></a>Menu: binary systems (tylko Unix)</h5> +<!--l. 886--><p class="noindent" ><hr class="figure"><div class="figure" +> + + +<a + id="x1-26043r4"></a> + + +<div class="fancyvrb" id="fancyvrb2"><a + id="x1-26002r1"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Available</span><span +class="ec-lmtt-8"> platforms:</span><span +class="ec-lmtt-8"> (Dostępne</span><span +class="ec-lmtt-8"> platformy:)</span><br class="fancyvrb" /><a + id="x1-26004r2"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> ===============================================================================</span> +<br class="fancyvrb" /><a + id="x1-26006r3"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> a</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> alpha-linux</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> DEC</span><span +class="ec-lmtt-8"> Alpha</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> GNU/Linux</span><br class="fancyvrb" /><a + id="x1-26008r4"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> b</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> amd64-freebsd</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> x86_64</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> FreeBSD</span> +<br class="fancyvrb" /><a + id="x1-26010r5"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> c</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> amd64-kfreebsd</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> x86_64</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> GNU/FreeBSD</span><br class="fancyvrb" /><a + id="x1-26012r6"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> d</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> armel-linux</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> ARM</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> GNU/Linux</span> +<br class="fancyvrb" /><a + id="x1-26014r7"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> e</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> i386-cygwin</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Intel</span><span +class="ec-lmtt-8"> x86</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> Cygwin</span><br class="fancyvrb" /><a + id="x1-26016r8"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> f</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> i386-freebsd</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Intel</span><span +class="ec-lmtt-8"> x86</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> FreeBSD</span> +<br class="fancyvrb" /><a + id="x1-26018r9"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> g</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> i386-kfreebsd</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Intel</span><span +class="ec-lmtt-8"> x86</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> GNU/FreeBSD</span><br class="fancyvrb" /><a + id="x1-26020r10"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> h</span><span +class="ec-lmtt-8"> [X]</span><span +class="ec-lmtt-8"> i386-linux</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Intel</span><span +class="ec-lmtt-8"> x86</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> GNU/Linux</span> +<br class="fancyvrb" /><a + id="x1-26022r11"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> i</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> i386-solaris</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Intel</span><span +class="ec-lmtt-8"> x86</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> Solaris</span><br class="fancyvrb" /><a + id="x1-26024r12"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> j</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> mips-irix</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> SGI</span><span +class="ec-lmtt-8"> IRIX</span><br class="fancyvrb" /><a + id="x1-26026r13"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> k</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> mipsel-linux</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> mipsel</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> Linux</span> +<br class="fancyvrb" /><a + id="x1-26028r14"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> l</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> powerpc-aix</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> PowerPC</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> AIX</span><br class="fancyvrb" /><a + id="x1-26030r15"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> m</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> powerpc-linux</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> PowerPC</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> GNU/Linux</span> +<br class="fancyvrb" /><a + id="x1-26032r16"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> o</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> sparc-solaris</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Sparc</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> Solaris</span><br class="fancyvrb" /><a + id="x1-26034r17"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> p</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> universal-darwin</span><span +class="ec-lmtt-8"> universal</span><span +class="ec-lmtt-8"> binaries</span><span +class="ec-lmtt-8"> for</span><span +class="ec-lmtt-8"> MacOSX/Darwin</span> +<br class="fancyvrb" /><a + id="x1-26036r18"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> s</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> win32</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Windows</span><br class="fancyvrb" /><a + id="x1-26038r19"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> t</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> x86_64-darwin</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> x86_64</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> MacOSX/Darwin</span> +<br class="fancyvrb" /><a + id="x1-26040r20"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> u</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> x86_64-linux</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> x86_64</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> GNU/Linux</span><br class="fancyvrb" /><a + id="x1-26042r21"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> v</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> x86_64-solaris</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> x86_64</span><span +class="ec-lmtt-8"> with</span><span +class="ec-lmtt-8"> Solaris</span></div> +<br /> <div class="caption" +><span class="id">Rysunek 4: </span><span +class="content">Wybór platformy (systemu operacyjnego)</span></div><!--tex4ht:label?: x1-26043r4 --> + + +<!--l. 911--><p class="noindent" ></div><hr class="endfigure"> +<!--l. 913--><p class="indent" > Rysunek <a +href="#x1-26043r4">4<!--tex4ht:ref: fig:bin-text --></a> pokazuje (w trybie tekstowym) wybór platformy (systemu operacyjnego). Domyślnie +instalowane są tylko programy dla bieżącej platformy, ale menu to pozwala wybrać także zestawy +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 dla kilku systemów na tej samej +maszynie. + <h5 class="subsubsectionHead"><span class="titlemark">3.2.2. </span> <a + id="x1-270003.2.2"></a>Wybór składników do instalacji</h5> +<!--l. 923--><p class="noindent" ><hr class="figure"><div class="figure" +> + + +<a + id="x1-27025r5"></a> + + +<div class="fancyvrb" id="fancyvrb3"><a + id="x1-27002r1"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Select</span><span +class="ec-lmtt-8"> scheme:</span><span +class="ec-lmtt-8"> (Wyb</span><span +class="ec-lmtt-8">ór</span><span +class="ec-lmtt-8"> schematu</span><span +class="ec-lmtt-8"> do</span><span +class="ec-lmtt-8"> instalacji:)</span><br class="fancyvrb" /><a + id="x1-27004r2"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> ===============================================================================</span> +<br class="fancyvrb" /><a + id="x1-27006r3"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> a</span><span +class="ec-lmtt-8"> [X]</span><span +class="ec-lmtt-8"> full</span><span +class="ec-lmtt-8"> scheme</span><span +class="ec-lmtt-8"> (everything)</span><br class="fancyvrb" /><a + id="x1-27008r4"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> b</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> medium</span><span +class="ec-lmtt-8"> scheme</span><span +class="ec-lmtt-8"> (small</span><span +class="ec-lmtt-8"> +</span><span +class="ec-lmtt-8"> more</span><span +class="ec-lmtt-8"> packages</span><span +class="ec-lmtt-8"> and</span><span +class="ec-lmtt-8"> languages)</span> +<br class="fancyvrb" /><a + id="x1-27010r5"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> c</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> small</span><span +class="ec-lmtt-8"> scheme</span><span +class="ec-lmtt-8"> (basic</span><span +class="ec-lmtt-8"> +</span><span +class="ec-lmtt-8"> xetex,</span><span +class="ec-lmtt-8"> metapost,</span><span +class="ec-lmtt-8"> a</span><span +class="ec-lmtt-8"> few</span><span +class="ec-lmtt-8"> languages)</span><br class="fancyvrb" /><a + id="x1-27012r6"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> d</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> basic</span><span +class="ec-lmtt-8"> scheme</span><span +class="ec-lmtt-8"> (plain</span><span +class="ec-lmtt-8"> and</span><span +class="ec-lmtt-8"> latex)</span> +<br class="fancyvrb" /><a + id="x1-27014r7"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> e</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> minimal</span><span +class="ec-lmtt-8"> scheme</span><span +class="ec-lmtt-8"> (plain</span><span +class="ec-lmtt-8"> only)</span><br class="fancyvrb" /><a + id="x1-27016r8"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> f</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> ConTeXt</span><span +class="ec-lmtt-8"> scheme</span><br class="fancyvrb" /><a + id="x1-27018r9"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> g</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> GUST</span><span +class="ec-lmtt-8"> TeX</span><span +class="ec-lmtt-8"> Live</span><span +class="ec-lmtt-8"> scheme</span> +<br class="fancyvrb" /><a + id="x1-27020r10"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> h</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> teTeX</span><span +class="ec-lmtt-8"> scheme</span><span +class="ec-lmtt-8"> (more</span><span +class="ec-lmtt-8"> than</span><span +class="ec-lmtt-8"> medium,</span><span +class="ec-lmtt-8"> but</span><span +class="ec-lmtt-8"> nowhere</span><span +class="ec-lmtt-8"> near</span><span +class="ec-lmtt-8"> full)</span><br class="fancyvrb" /><a + id="x1-27022r11"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> i</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> XML</span><span +class="ec-lmtt-8"> scheme</span><br class="fancyvrb" /><a + id="x1-27024r12"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> j</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><span +class="ec-lmtt-8"> custom</span><span +class="ec-lmtt-8"> selection</span><span +class="ec-lmtt-8"> of</span><span +class="ec-lmtt-8"> collections</span></div> +<br /> <div class="caption" +><span class="id">Rysunek 5: </span><span +class="content">Menu: wybór schematów</span></div><!--tex4ht:label?: x1-27025r5 --> + + +<!--l. 939--><p class="noindent" ></div><hr class="endfigure"> +<!--l. 941--><p class="indent" > Rysunek <a +href="#x1-27025r5">5<!--tex4ht:ref: fig:scheme-text --></a> pokazuje menu „Wybór schematów”. Schematy to obszerne zestawy pakietów, przeznaczone do +wstępnego wyboru instalowanych komponentów. Mamy tu schematy do instalacji: podstawowej (<span +class="ec-lmtt-10">basic</span>), +typowej (<span +class="ec-lmtt-10">medium</span>) i pełnej (<span +class="ec-lmtt-10">full</span>; jest ona domyślna), pozostałe przygotowano z myślą o wybranych grupach +użytkowników (np. GUST) lub zastosowaniach (np. XML lub ConTeXt). +<!--l. 948--><p class="indent" > <hr class="figure"><div class="figure" +> + + +<a + id="x1-27026r6"></a> + + +<div class="center" +> +<!--l. 949--><p class="noindent" > + +<!--l. 950--><p class="noindent" ><img +src="../texlive-common/stdcoll.png" alt="pict" +> +<br /> <div class="caption" +><span class="id">Rysunek 6: </span><span +class="content">Menu Collections (Kolekcje)</span></div><!--tex4ht:label?: x1-27026r6 --> +</div> + + +<!--l. 953--><p class="indent" > </div><hr class="endfigure"> +<!--l. 955--><p class="indent" > Wstępnie wybrane schematy można modyfikować. W skład ,schematów” wchodzą tzw. „kolekcje”, które +można wybrać w kolejnych menu o nazwach: „Kolekcje standardowe” i „Kolekcje językowe” (rys. <a +href="#x1-27026r6">6<!--tex4ht:ref: fig:collections-gui --></a>). Kolekcje +stanowią niższy poziom niż schematy, a same składają się z „pakietów”. Dopiero pakiety zawierają właściwe +pliki makr, fontów itp. Jeśli chcemy dodać lub usunąć pakiet, to po instalacji właściwej użyjemy programu +<span class="TEX">T<span +class="E">E</span>X</span> Live Manager (<span +class="ec-lmss-10">tlmgr</span>, patrz część <a +href="#x1-460005">5<!--tex4ht:ref: sec:tlmgr --></a>). + <h5 class="subsubsectionHead"><span class="titlemark">3.2.3. </span> <a + id="x1-280003.2.3"></a>Katalogi</h5> +<!--l. 966--><p class="noindent" >Domyślny układ katalogów opisano w części <a +href="#x1-110002.3">2.3<!--tex4ht:ref: sec:texmftrees --></a> na str. <a +href="#x1-110002.3">9<!--tex4ht:ref: sec:texmftrees --></a>. Położenie domyślne całej instalacji (<span +class="ec-lmtt-10">TEXDIR</span>) różni +się w Windows (<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">%SystemDrive%\texlive\2012</span></span></span>) i w Unix (<span +class="ec-lmtt-10">/usr/local/texlive/2012</span>). +<!--l. 971--><p class="indent" > Głównym powodem, dla którego chcielibyśmy ewentualnie zmienić domyślne położenie <span +class="ec-lmtt-10">TEXDIR</span>, może być +brak uprawnień systemowych. Aby zainstalować <span class="TEX">T<span +class="E">E</span>X</span> Live, nie musimy być administratorem systemu, musimy +jednak posiadać uprawnienia do zapisu w docelowym katalogu. Rozsądną alternatywą może być wtedy +instalacja w katalogu domowym, szczególnie gdy będziemy jej jedynym użytkownikiem. Stosujemy tu zapis +„<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">~</span></span></span>” do zaznaczenia katalogu domowego użytkownika, np. <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">~/texlive/2012</span></span></span>. Zalecamy użycie katalogu z nazwą +odzwierciedlającą rok wydania, co pozwoli na zainstalowanie obok siebie różnych wydań <span class="TEX">T<span +class="E">E</span>X</span> +Live. +<!--l. 985--><p class="indent" > Zmiana <span +class="ec-lmtt-10">TEXDIR </span>w programie instalacyjnym zmieni także ścieżki katalogów określone przez zmienne +<span +class="ec-lmtt-10">TEXMFLOCAL</span>, <span +class="ec-lmtt-10">TEXMFSYSVAR </span>i <span +class="ec-lmtt-10">TEXMFSYSCONFIG</span>. +<!--l. 989--><p class="indent" > <span +class="ec-lmtt-10">TEXMFHOME </span>jest zalecanym położeniem dla prywatnych makr i fontów użytkownika. Domyślnym +katalogiem jest <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">~/texmf</span></span></span>. W odróżnieniu od <span +class="ec-lmtt-10">TEXDIR</span>, znak <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">~</span></span></span> 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 <span +class="ec-lmtt-10">$HOME </span>w Unix i <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">%USERPROFILE%</span></span></span> w Windows. +Po raz kolejny podkreślmy, że tak jak inne drzewa katalogów, <span +class="ec-lmtt-10">TEXMFHOME </span>musi mieć strukturę zgodną z +TDS. +<!--l. 998--><p class="indent" > Katalog określany przez zmienną <span +class="ec-lmtt-10">TEXMFVAR </span>przechowuje dane konfiguracyjne specyficzne dla każdego +użytkownika. Katalog określany przez zmienną <span +class="ec-lmtt-10">TEXMFCACHE </span>przechowuje dane buforowane (<span +class="ec-lmri-10">cached</span>) +Con<span class="TEX">T<span +class="E">E</span>X</span>t MkIV (patrz część <a +href="#x1-370003.4.5">3.4.5<!--tex4ht:ref: sec:context-mkiv --></a>, na str. <a +href="#x1-370003.4.5">39<!--tex4ht:ref: sec:context-mkiv --></a>). +<!--l. 1004--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.2.4. </span> <a + id="x1-290003.2.4"></a>Opcje</h5> +<!--l. 1007--><p class="noindent" ><hr class="figure"><div class="figure" +> + + +<a + id="x1-29025r7"></a> + + +<div class="fancyvrb" id="fancyvrb4"><a + id="x1-29002r1"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Options</span><span +class="ec-lmtt-8"> setup:</span><br class="fancyvrb" /><a + id="x1-29004r2"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> ===============================================================================</span> +<br class="fancyvrb" /><a + id="x1-29006r3"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> <P></span><span +class="ec-lmtt-8"> use</span><span +class="ec-lmtt-8"> letter</span><span +class="ec-lmtt-8"> size</span><span +class="ec-lmtt-8"> instead</span><span +class="ec-lmtt-8"> of</span><span +class="ec-lmtt-8"> A4</span><span +class="ec-lmtt-8"> by</span><span +class="ec-lmtt-8"> default:</span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><br class="fancyvrb" /><a + id="x1-29008r4"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> <E></span><span +class="ec-lmtt-8"> execution</span><span +class="ec-lmtt-8"> of</span><span +class="ec-lmtt-8"> restricted</span><span +class="ec-lmtt-8"> list</span><span +class="ec-lmtt-8"> of</span><span +class="ec-lmtt-8"> programs:</span><span +class="ec-lmtt-8"> [X]</span> +<br class="fancyvrb" /><a + id="x1-29010r5"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> <F></span><span +class="ec-lmtt-8"> create</span><span +class="ec-lmtt-8"> all</span><span +class="ec-lmtt-8"> format</span><span +class="ec-lmtt-8"> files:</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> [X]</span><br class="fancyvrb" /><a + id="x1-29012r6"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> <D></span><span +class="ec-lmtt-8"> install</span><span +class="ec-lmtt-8"> font/macro</span><span +class="ec-lmtt-8"> doc</span><span +class="ec-lmtt-8"> tree:</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> [X]</span> +<br class="fancyvrb" /><a + id="x1-29014r7"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> <S></span><span +class="ec-lmtt-8"> install</span><span +class="ec-lmtt-8"> font/macro</span><span +class="ec-lmtt-8"> source</span><span +class="ec-lmtt-8"> tree:</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> [X]</span><br class="fancyvrb" /><a + id="x1-29016r8"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> <L></span><span +class="ec-lmtt-8"> create</span><span +class="ec-lmtt-8"> symlinks</span><span +class="ec-lmtt-8"> in</span><span +class="ec-lmtt-8"> standard</span><span +class="ec-lmtt-8"> directories:</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> [</span><span +class="ec-lmtt-8"> ]</span><br class="fancyvrb" /><a + id="x1-29018r9"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> binaries</span><span +class="ec-lmtt-8"> to:</span> +<br class="fancyvrb" /><a + id="x1-29020r10"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> manpages</span><span +class="ec-lmtt-8"> to:</span><br class="fancyvrb" /><a + id="x1-29022r11"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> info</span><span +class="ec-lmtt-8"> to:</span><br class="fancyvrb" /><a + id="x1-29024r12"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> <Y></span><span +class="ec-lmtt-8"> after</span><span +class="ec-lmtt-8"> installation,</span><span +class="ec-lmtt-8"> get</span><span +class="ec-lmtt-8"> package</span><span +class="ec-lmtt-8"> updates</span><span +class="ec-lmtt-8"> from</span><span +class="ec-lmtt-8"> CTAN:</span><span +class="ec-lmtt-8"> [X]</span></div> +<br /> <div class="caption" +><span class="id">Rysunek 7: </span><span +class="content">Menu: Options (Opcje) w Unix</span></div><!--tex4ht:label?: x1-29025r7 --> + + +<!--l. 1023--><p class="noindent" ></div><hr class="endfigure"> +<!--l. 1025--><p class="indent" > Rysunek <a +href="#x1-29025r7">7<!--tex4ht:ref: fig:options-text --></a> pokazuje menu (w trybie tekstowym) z dodatkowymi opcjami. Warto tu je wymienić: + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">use letter size instead of A4 by default</span> </dt><dd +class="description">(użyj domyślnie formatu papieru letter zamiast A4): + pozwala określić domyślny format papieru dla wielu programów. Oczywiście format papieru + można (nawet: należy) specyfikować dla każdego dokumentu w miarę potrzeby. + </dd><dt class="description"> +<span +class="ec-lmbx-10">execution of restricted list of programs</span> </dt><dd +class="description">(zezwalaj na uruchomienie niektórych programów): od + <span class="TEX">T<span +class="E">E</span>X</span> Live 2010 wykonanie niektórych przydatnych programów pomocniczych, uruchamianych + jako podprocesy (w „tle”), zostało zastrzeżone dla ich niewielkiej listy, zamieszczonej w pliku + <span +class="ec-lmtt-10">texmf.cnf</span>. Szczegóły znajdziesz w części „Wydanie 2010” (<a +href="#x1-8500011.7">11.7<!--tex4ht:ref: sec:2010news --></a>). + </dd><dt class="description"> +<span +class="ec-lmbx-10">create format files</span> </dt><dd +class="description">(generuj pliki formatów): chociaż zbędne formaty zajmują miejsce na dysku, + zaleca się pozostawić tę opcję włączoną; jeśli tego nie zrobimy, formaty będą generowane + automatycznie (w razie potrzeby) w prywatnych katalogach <span +class="ec-lmtt-10">TEXMFVAR </span>użytkowników, nie będą + jednak odświeżane, gdy w instalacji zostaną zaktualizowane np. same programy bądź wzorce + przenoszenia; wskutek tego pliki formatów mogą utracić zgodność ze środowiskiem, w którym + są używane. + </dd><dt class="description"> +<span +class="ec-lmbx-10">install font/macro </span><span +class="ec-lmbx-10">…</span><span +class="ec-lmbx-10"> tree</span> </dt><dd +class="description">(instaluj pliki źródłowe i/lub dokumentacji dla fontów bądź makr): + wprawdzie wyłączenie tych opcji pozwala zaoszczędzić miejsce na dysku, ale nie jest zalecane. + </dd><dt class="description"> +<span +class="ec-lmbx-10">create symlinks in standard directories</span> </dt><dd +class="description">(utwórz dowiązania w standardowych + katalogach, dotyczy tylko Unix): opcja ta pozwala uniknąć ustawiania zmiennych środowiska + po instalacji (<span +class="ec-lmtt-10">PATH</span>, <span +class="ec-lmtt-10">MANPATH </span>i <span +class="ec-lmtt-10">INFOPATH</span>), ale jej użycie nie jest zalecane, bo może powodować + kolizje z już zainstalowanym w systemie środowiskiem <span class="TEX">T<span +class="E">E</span>X</span>; może być ona przydatna jedynie + wtedy, gdy w standardowych katalogach (np. <span +class="ec-lmtt-10">/usr/local/bin</span>) nie ma jakichkolwiek programów + <span class="TEX">T<span +class="E">E</span>X</span>-owych. Wymaga ona ponadto uprawnień do zapisu w docelowych katalogach. + </dd><dt class="description"> +<span +class="ec-lmbx-10">after installation </span><span +class="ec-lmbx-10">…</span><span +class="ec-lmbx-10"> CTAN</span> </dt><dd +class="description">(po instalacji użyj CTAN, aby pobrać aktualizacje): gdy instalujemy + z DVD, opcja ta jest domyślnie włączona, co pozwala dokonać aktualizacji zainstalowanych + pakietów z sieci (z kopii CTAN). Jedyny powód, dla którego moglibyśmy wyłączyć tę opcję, to + sytuacja, gdy instalujemy tylko część pakietów i zamierzamy potem doinstalować z DVD inne. + Tak czy inaczej, repozytorium pakietów do instalacji bądź aktualizacji może być w każdej + chwili zmienione w linii poleceń, lub po wyborze odpowiedniego menu programu <span +class="ec-lmss-10">tlmgr </span>w trybie + graficznym. Patrz część <a +href="#x1-310003.3.1">3.3.1<!--tex4ht:ref: sec:location --></a> i część <a +href="#x1-350003.4.3">3.4.3<!--tex4ht:ref: sec:dvd-install-net-updates --></a>.</dd></dl> +<!--l. 1074--><p class="indent" > Po wykonaniu wszystkich potrzebnych ustawień można rozpocząć instalację (klawisz „I”). +Po instalacji zaleca się zajrzeć do części <a +href="#x1-320003.4">3.4<!--tex4ht:ref: sec:postinstall --></a>, bo być może będą jeszcze potrzebne dodatkowe +kroki. + <h4 class="subsectionHead"><span class="titlemark">3.3. </span> <a + id="x1-300003.3"></a>Parametry instalacji z linii poleceń</h4> +<!--l. 1137--><p class="noindent" >Uruchom <div class="alltt"> +<!--l. 1138--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">install-tl</span><span +class="ec-lmtk-10"> -help</span> +</div> +</div> aby wyświetlić wszystkie dostępne parametry. Oto najczęściej używane: +<!--l. 1145--><p class="noindent" > + <dl class="list1"><dt class="list"> + <span +class="ec-lmtt-10">-gui</span> </dt><dd +class="list"> + <!--l. 1146--><p class="noindent" >użyj (jeśli to możliwe) programu w wersji graficznej (GUI); wymagane jest posiadanie modułu + Perl/Tk (<a +href="http://tug.org/texlive/distro.html#perltk" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/distro.html#perltk</span></a>) skompilowanego ze wsparciem dla + XFT; gdy jest on niedostępny, program instalacyjny uruchomiony zostanie w trybie tekstowym; + + + </dd><dt class="list"> + <span +class="ec-lmtt-10">-no-gui</span> </dt><dd +class="list"> + <!--l. 1152--><p class="noindent" >wymusza tryb tekstowy, np. w Windows. + </dd><dt class="list"> + <span +class="ec-lmtt-10">-lang </span><span +class="ec-lmro-10">ll</span> </dt><dd +class="list"> + <!--l. 1153--><p class="noindent" >pozwala wybrać język komunikatów, <span +class="ec-lmri-10">ll </span>oznacza tu dwuliterowy kod języka; listę dostępnych + języków wyświetli <span +class="ec-lmtt-10">install-tl –help</span>; program samoczynnie wykrywa język systemu, ale jeśli + jest to niemożliwe, komunikaty i menu będą wyświetlane w języku angielskim; + <!--l. 1173--><p class="noindent" ><a id="opt-in-place"></a> + </dd><dt class="list"> + <span +class="ec-lmtt-10">-in-place</span> </dt><dd +class="list"> + <!--l. 1174--><p class="noindent" >jeśli posiadamy kopię repozytorium <span class="TEX">T<span +class="E">E</span>X</span> Live uzyskaną via rsync, svn itp. (patrz + <a +href="http://tug.org/texlive/acquire-mirror.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/acquire-mirror.html</span></a>), opcja ta pozwala na wykorzystanie jako + instalacji owej kopii i jedynie wykona kroki poinstalacyjne (konfigurację). <span +class="ec-lmbx-10">Uwaga: </span>plik + <span +class="ec-lmtt-10">tlpkg/texlive.tlpdb </span>może zostać nadpisany, a więc warto go uprzednio skopiować w bezpieczne + miejsce. Ponadto usuwanie zbędnych pakietów należy wykonać wtedy ręcznie, słowem, użycie tej + opcji zaleca się jedynie zaawansowanym użytkownikom. Opcja ta może być włączona/wyłączona + w programie instalacyjnym. + </dd><dt class="list"> + <span +class="ec-lmtt-10">-portable</span> </dt><dd +class="list"> + <!--l. 1184--><p class="noindent" >instalacja do użycia przenośnego, np. na pen drivie; opcja ta może być użyta zarówno w trybie + tekstowym (poleceniem <span +class="ec-lmtt-10">V</span>), jak i przez wyb˘r odpowiedniego przycisku programu instalacyjnego + w trybie GUI (patrz część  <a +href="#x1-440004.2">4.2<!--tex4ht:ref: sec:portable-tl --></a>). + </dd><dt class="list"> + <span +class="ec-lmtt-10">-profile </span><span +class="ec-lmro-10">plik</span> </dt><dd +class="list"> + <!--l. 1189--><p class="noindent" >wczytuje <span +class="ec-lmro-10">plik </span>profilu instalacji i przebiega ona bez interakcji ze strony użytkownika; program + instalacyjny zapisuje plik <span +class="ec-lmtt-10">texlive.profile </span>w katalogu <span +class="ec-lmtt-10">tlpkg </span>naszej instalacji, co pozwala + wykorzystać go dla powielenia w trybie wsadowym wszystkich wyborów i ustawień w kolejnych + instalacjach; + </dd><dt class="list"> + <span +class="ec-lmtt-10">-repository </span><span +class="ec-lmro-10">url-lub-</span><span +class="ec-lmro-10">ście</span><span +class="ec-lmro-10">żka</span> </dt><dd +class="list"> + <!--l. 1196--><p class="noindent" >pozwala określić inne niż domyślne źródło instalacji (patrz poniżej).</dd></dl> +<!--l. 1200--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.3.1. </span> <a + id="x1-310003.3.1"></a>Parametr <span +class="ec-lmtt-10">-repository</span></h5> +<!--l. 1203--><p class="noindent" >Domyślnym repozytorium pakietów dla <span class="TEX">T<span +class="E">E</span>X</span> Live jest kopia (<span +class="ec-lmri-10">mirror</span>) CTAN, znajdywana automatycznie +poprzez sewis <a +href="http://mirror.ctan.org" class="url" ><span +class="ec-lmtt-10">http://mirror.ctan.org</span></a>. +<!--l. 1206--><p class="indent" > Parametrowi <span +class="ec-lmtt-10">-repository </span>można przypisać adres w sieci (rozpoczynający się od <span +class="ec-lmtt-10">ftp:</span>, <span +class="ec-lmtt-10">http: </span>lub <span +class="ec-lmtt-10">file:/</span>) +lub pełną ścieżkę do kopii pakietów na dysku (np. pobranej za pomocą programu <span +class="ec-lmtt-10">wget </span>lub <span +class="ec-lmtt-10">rsync</span>). Jeśli +podany argument wskazuje na lokalny dysk (ścieżkę bądź adres <span +class="ec-lmtt-10">file:/</span>), wybrana zostanie instalacja ze +skompresowanych plików <span +class="ec-lmtt-10">tar.xz</span>, zawartych w podkatalogu <span +class="ec-lmtt-10">archive</span>. (Podając adres <span +class="ec-lmtt-10">http:</span> lub +<span +class="ec-lmtt-10">ftp:</span> końcowy znak ‘<span +class="ec-lmtt-10">/</span>’ lub komponent ‘<span +class="ec-lmtt-10">/tlpkg</span>’ są ignorowane.) +<!--l. 1216--><p class="indent" > Przykładowo, można wybrać konkretną kopię (zwierciadło) CTAN z +<a +href="http://ctan.example.org/tex-archive/systems/texlive/tlnet/" class="url" ><span +class="ec-lmtt-10">http://ctan.example.org/tex-archive/systems/texlive/tlnet/</span></a> podstawiając prawdziwą nazwę hosta i +jego konkretną ścieżkę do korzenia CTAN zamiast <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">ctan.example.org/tex-archive</span></span></span>. Lista zwierciadeł +CTAN jest dostępna na stronie <a +href="http://ctan.org/mirrors" class="url" ><span +class="ec-lmtt-10">http://ctan.org/mirrors</span></a>. +<!--l. 1222--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">3.4. </span> <a + id="x1-320003.4"></a>Czynności poinstalacyjne</h4> + + +<!--l. 1233--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.4.1. </span> <a + id="x1-330003.4.1"></a>Zmienne środowiska dla Unix</h5> +<!--l. 1236--><p class="noindent" >Użycie opisanej w części <a +href="#x1-290003.2.4">3.2.4<!--tex4ht:ref: sec:options --></a> opcji tworzenia dowiązań symbolicznych w standardowych katalogach nie +wymaga zmian w zmiennych środowiska systemowego. Niemniej jednak w systemach Unix po instalacji należy +do zmiennej <span +class="ec-lmtt-10">PATH </span>dodać ścieżkę do programów <span class="TEX">T<span +class="E">E</span>X</span> Live. (W Windows program instalacyjny czyni to za +nas.) +<!--l. 1242--><p class="indent" > Każda z obsługiwanych platform ma własny podkatalog w ramach <span +class="ec-lmtt-10">TEXDIR/bin</span>. Listę platform i +odpowiadających im katalogów przedstawiono na rys. <a +href="#x1-26043r4">4<!--tex4ht:ref: fig:bin-text --></a>. +<!--l. 1246--><p class="indent" > Również korzystanie z systemowych przeglądarek dokumentacji <span +class="ec-lmss-10">man </span>i <span +class="ec-lmss-10">info </span>staje się możliwe dopiero po +dodaniu odpowiednich katalogów do ich ścieżek przeszukiwania. Strony <span +class="ec-lmss-10">man </span>mogą być także znajdywane +automatycznie po dodaniu ścieżki ich położenia do <span +class="ec-lmtt-10">MANPATH</span>. +<!--l. 1252--><p class="indent" > Dla powłoki zgodnej z Bourne shell (<span +class="ec-lmss-10">sh</span>, <span +class="ec-lmss-10">bash</span>, <span +class="ec-lmss-10">ksh</span>) możemy dopisać do pliku <span +class="ec-lmtt-10">$HOME/.profile</span>: +<!--l. 1255--><p class="indent" > + <div class="fancyvrb" id="fancyvrb5"><a + id="x1-33002r1"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> PATH=/usr/local/texlive/2012/bin/i386-linux:$PATH;</span><span +class="ec-lmtt-9"> export</span><span +class="ec-lmtt-9"> PATH</span> +<br class="fancyvrb" /><a + id="x1-33004r2"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> MANPATH=/usr/local/texlive/2012/texmf/doc/man:$MANPATH;</span><span +class="ec-lmtt-9"> export</span><span +class="ec-lmtt-9"> MANPATH</span> +<br class="fancyvrb" /><a + id="x1-33006r3"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> INFOPATH=/usr/local/texlive/2012/texmf/doc/info:$INFOPATH;</span><span +class="ec-lmtt-9"> export</span><span +class="ec-lmtt-9"> INFOPATH</span></div> +<!--l. 1261--><p class="indent" > W wypadku csh lub tcsh należy zmodyfikować plik <span +class="ec-lmtt-10">$HOME/.cshrc</span>, np.: +<!--l. 1263--><p class="indent" > + <div class="fancyvrb" id="fancyvrb6"><a + id="x1-33008r1"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> setenv</span><span +class="ec-lmtt-9"> PATH</span><span +class="ec-lmtt-9"> /usr/local/texlive/2012/bin/i386-linux:$PATH</span><br class="fancyvrb" /><a + id="x1-33010r2"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> setenv</span><span +class="ec-lmtt-9"> MANPATH</span><span +class="ec-lmtt-9"> /usr/local/texlive/2012/texmf/doc/man:$MANPATH</span> +<br class="fancyvrb" /><a + id="x1-33012r3"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> setenv</span><span +class="ec-lmtt-9"> INFOPATH</span><span +class="ec-lmtt-9"> /usr/local/texlive/2012/texmf/doc/info:$INFOPATH</span></div> +<!--l. 1269--><p class="indent" > Jeśli są już jakieś ustawienia zawarte w prywatnych plikach konfiguracyjnych, wówczas oczywiście katalogi +<span class="TEX">T<span +class="E">E</span>X</span> Live powinny być tam odpowiednio wkomponowane. +<!--l. 1272--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.4.2. </span> <a + id="x1-340003.4.2"></a>Zmienne środowiska: konfiguracja globalna</h5> +<!--l. 1275--><p class="noindent" >Jeśli zmiany mają być dokonane globalnie, lub jeśli mają być dokonane dla nowego użytkownika systemu, +wówczas należy dokonać tego na własną rękę – jest zbyt wiele możliwości dla różnych systemów dotyczących +miejsca i sposobu konfiguracji. +<!--l. 1280--><p class="indent" > Nasze dwie rady są następujące: 1) można sprawdzić plik <span +class="ec-lmtt-10">/etc/manpath.config </span>i, jeśli jest obecny, +dodać w nim wiersze + <div class="fancyvrb" id="fancyvrb7"><a + id="x1-34002r1"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> MANPATH_MAP</span><span +class="ec-lmtt-9"> /usr/local/texlive/2012/bin/i386-linux</span><span +class="ec-lmtt-9"> \</span><br class="fancyvrb" /><a + id="x1-34004r2"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> /usr/local/texlive/2012/texmf/doc/man</span></div> +<!--l. 1286--><p class="noindent" >2) można sprawdzić plik <span +class="ec-lmtt-10">/etc/environment</span>, w którym może być zdefiniowana ścieżka wyszukiwania i inne +domyślne zmienne środowiska. +<!--l. 1289--><p class="indent" > W każdym katalogu w plikami wykonywalnymi systemów uniksowych możemy utworzyć symboliczne +dowiązanie o nazwie <span +class="ec-lmtt-10">man </span>do katalogu <span +class="ec-lmtt-10">texmf/doc/man</span>. Niektóre programy <span +class="ec-lmtt-10">man</span>, np. standardowy program <span +class="ec-lmtt-10">man</span> +w systemie Mac OS X, automatycznie znajdą to dowiązanie, likwidując potrzebę jakiegokolwiek ustawiania dla +stron manuala. +<!--l. 1295--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.4.3. </span> <a + id="x1-350003.4.3"></a>Aktualizacje z internetu po instalacji z DVD</h5> +<!--l. 1298--><p class="noindent" >Po instalacji z DVD i <span +class="ec-lmbx-10">po modyfikacji </span>ścieżki wyszukiwania programów (jak opisano to powyżej), możemy +pobrać z internetu aktualizacje pakietów: + <div class="alltt"> +<!--l. 1302--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tlmgr</span><span +class="ec-lmtk-10"> option</span><span +class="ec-lmtk-10"> repository</span><span +class="ec-lmtk-10"> http://mirror.ctan.org/systems/texlive/tlnet</span> +</div> +</div> +<!--l. 1306--><p class="indent" > Wówczas pakiety będą aktualizowane z najbliższej, automatycznie znalezionej kopii archiwów CTAN (co +domyślnie włączono podczas instalacji). Jeśli wystąpią problemy z automatycznym wyborem archiwum, +należy podać konkretny adres (listę adresów znajdziemy na <a +href="http://ctan.org/mirrors" class="url" ><span +class="ec-lmtt-10">http://ctan.org/mirrors</span></a>) wraz z pełną ścieżką +do podkatalogu <span +class="ec-lmtt-10">tlnet</span>. +<!--l. 1312--><p class="indent" > <a id="xetexfontconfig"></a> <a id="sysfontconfig"></a> + + + <h5 class="subsubsectionHead"><span class="titlemark">3.4.4. </span> <a + id="x1-360003.4.4"></a>Konfiguracja fontów dla Xe<span class="TEX">T<span +class="E">E</span>X</span> i Lua<span class="TEX">T<span +class="E">E</span>X</span></h5> +<!--l. 1317--><p class="noindent" >Xe<span class="TEX">T<span +class="E">E</span>X</span> i Lua<span class="TEX">T<span +class="E">E</span>X</span> pozwalają użyć każdy font zainstalowany w systemie, nie tylko fonty znajdujące się +w katalogach <span class="TEX">T<span +class="E">E</span>X</span>-owych. Korzystają tu ze zbliżonych, ale jednak różnych metod. +<!--l. 1321--><p class="indent" > W systemach Windows fonty dostarczone z <span class="TEX">T<span +class="E">E</span>X</span> Live są automatycznie dostępne dla programu Xe<span class="TEX">T<span +class="E">E</span>X</span>. +Gdy w systemie uniksowym zainstalowano <span +class="ec-lmtt-10">xetex</span>, należy skonfigurować system tak, aby program ten mógł +znaleźć fonty dostarczone w <span class="TEX">T<span +class="E">E</span>X</span> Live. Aby to ułatwić, podczas instalacji pakietu tworzony jest plik +konfiguracyjny fontów: <span +class="ec-lmtt-10">TEXMFSYSVAR/fonts/conf/texlive-fontconfig.conf</span>. +<!--l. 1329--><p class="indent" > Aby udostępnić fonty <span class="TEX">T<span +class="E">E</span>X</span> Live dla innych aplikacji systemu (zakładając, że mamy odpowiednie +uprawnienia) należy wykonać następujące czynności: + <ol class="enumerate1" > + <li + class="enumerate" id="x1-36002x1">skopiować <span +class="ec-lmtt-10">texlive-fontconfig.conf </span>do <span +class="ec-lmtt-10">/etc/fonts/conf.d/09-texlive.conf</span>; + </li> + <li + class="enumerate" id="x1-36004x2">uruchomić <span +class="ec-lmtk-10">fc-cache -fsv</span>.</li></ol> +<!--l. 1338--><p class="indent" > Jeśli nie mamy odpowiednich uprawnień i chcemy podczas uruchamiania Xe<span class="TEX">T<span +class="E">E</span>X</span>-a korzystać jedynie +z fontów dostępnych w <span class="TEX">T<span +class="E">E</span>X</span> Live, należy: + <ol class="enumerate1" > + <li + class="enumerate" id="x1-36006x1">skopiować plik <span +class="ec-lmtt-10">texlive-fontconfig.conf </span>do <span +class="ec-lmtt-10">~/.fonts.conf</span>, gdzie <span +class="ec-lmtt-10">~ </span>oznacza nasz katalog + domowy. + </li> + <li + class="enumerate" id="x1-36008x2">uruchomić <span +class="ec-lmtk-10">fc-cache -fv</span>.</li></ol> +<!--l. 1346--><p class="indent" > Uruchomienie programu <span +class="ec-lmtt-10">fc-list </span>pozwala wyświetlić nazwy fontów systemowych. <span +class="ec-lmtt-10">fc-list : family</span> +<span +class="ec-lmtt-10">style file spacing </span>pokaże więcej interesujących informacji. +<!--l. 1380--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.4.5. </span> <a + id="x1-370003.4.5"></a>Con<span class="TEX">T<span +class="E">E</span>X</span>t Mark IV</h5> +<!--l. 1383--><p class="noindent" >Zarówno tzw. „stary” Con<span class="TEX">T<span +class="E">E</span>X</span>t (Mark II), jak i nowy Con<span class="TEX">T<span +class="E">E</span>X</span>t (Mark IV, oparty na Lua<span class="TEX">T<span +class="E">E</span>X</span>) powinny +działać po instalacji <span class="TEX">T<span +class="E">E</span>X</span> Live bez problemów, o ile do aktualizacji będziemy używać wyłącznie programu +<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">tlmgr</span></span></span>. +<!--l. 1388--><p class="indent" > Ponieważ Con<span class="TEX">T<span +class="E">E</span>X</span>t MkIV nie stosuje biblioteki kpathsea do wyszukiwania plików, po zainstalowaniu +ręcznie nowych plików (bez użycia <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">tlmgr</span></span></span>) wymagane jest uruchomienie: + <div class="fancyvrb" id="fancyvrb8"><a + id="x1-37002r1"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> context</span><span +class="ec-lmtt-9"> --generate</span></div> +<!--l. 1394--><p class="noindent" >do odświeżenia danych buforowych Con<span class="TEX">T<span +class="E">E</span>X</span>t. Wygenerowane dane buforowe zostaną zapisane w katalogach +wskazywanych przez zmienną <span +class="ec-lmtt-10">TEXMFCACHE </span>(domyślna wartość w <span class="TEX">T<span +class="E">E</span>X</span> Live tej zmiennej to +<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">TEXMSYSVAR;TEXMFVAR</span></span></span>). +<!--l. 1399--><p class="indent" > Con<span class="TEX">T<span +class="E">E</span>X</span>t MkIV przeszuka wszystkie ścieżki wymienione w <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">TEXMFCACHE</span></span></span> i zapisze dane w pierwszej ścieżce, +która jest dostępna do zapisu. Gdy dane buforowe są zduplikowane, podczas ich odczytywania zostaną +wykorzystane ostatnio znalezione. +<!--l. 1404--><p class="indent" > Więcej informacji znajdziemy na stronach: <a +href="http://wiki.contextgarden.net/Running_Mark_IV" class="url" ><span +class="ec-lmtt-10">http://wiki.contextgarden.net/Running_Mark_IV</span></a>. +<!--l. 1407--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.4.6. </span> <a + id="x1-380003.4.6"></a>Integracja lokalnych i prywatnych pakietów makr</h5> +<!--l. 1410--><p class="noindent" >Jak już wspomniano w części <a +href="#x1-110002.3">2.3<!--tex4ht:ref: sec:texmftrees --></a>, katalog <span +class="ec-lmtt-10">TEXMFLOCAL </span>(domyślnie <span +class="ec-lmtt-10">/usr/local/texlive/texmf-local </span>lub +<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">%SystemDrive%\texlive\texmf-local</span></span></span> w Windows) przeznaczony jest na lokalne (np. w danej +sieci komputerowej) fonty oraz pakiety makr. Z kolei <span +class="ec-lmtt-10">TEXMFHOME </span>(domyślnie <span +class="ec-lmtt-10">$HOME/texmf </span>lub +<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">%USERPROFILE%\texmf</span></span></span>) jest przeznaczony na prywatne makra i fonty użytkownika. W zamierzeniu oba te +katalogi powinny być zachowywane przy instalacji nowszych wersji <span class="TEX">T<span +class="E">E</span>X</span> Live, a ich zawartość ma być +automatycznie dostępna w kolejnych wydaniach. Zalecamy zatem, by nie przedefiniowywać <span +class="ec-lmtt-10">TEXMFLOCAL</span>, co +pozwoli uniknąć ręcznego konfigurowania w przyszłości. +<!--l. 1422--><p class="indent" > W obu drzewach katalogów pliki powinny być umieszczane w odpowiednich podkatalogach, zgodnie +z zaleceniami TDS (patrz: <a +href="http://tug.org/tds" class="url" ><span +class="ec-lmtt-10">http://tug.org/tds</span></a>, także plik <span +class="ec-lmtt-10">texmf/web2c/texmf.cnf</span>). Przykładowo pliki +klas lub makr <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>-a powinny być umieszczane w katalogu <span +class="ec-lmtt-10">TEXMFLOCAL/tex/latex/ </span>lub +<span +class="ec-lmtt-10">TEXMFHOME/tex/latex/ </span>(lub ich podkatalogach). + + +<!--l. 1429--><p class="indent" > <span +class="ec-lmtt-10">TEXMFLOCAL </span>po zmianie zawartości wymaga odświeżenia bazy danych – poleceniem <span +class="ec-lmss-10">mktexlsr </span>lub +poprzez użycie przycisku „Odśwież bazy danych” w graficznym trybie programu TeX Live Manager +(<span +class="ec-lmss-10">tlmgr</span>). +<!--l. 1433--><p class="indent" > Każda z tych zmiennych ma domyślnie przypisany pojedynczy katalog, ale nie musi być to regułą. Jeśli +testujemy różne wersje pakietów, możemy do własnych celów zakładać kolejne drzewa katalogów i przełączać +kolejność ich przeszukiwania. Wystarczy zadeklarować zmienną <span +class="ec-lmtt-10">TEXMFHOME </span>dla listy katalogów, które +oddzielamy przecinkami i umieszczamy w klamrach: + + + <div class="verbatim" id="verbatim-1"> + <div class="fancyvrb" id="fancyvrb9"><a + id="x1-38002r1"></a>    TEXMFHOME = {/my/dir1,/mydir2,/a/third/dir}</div> +</div> +<!--l. 1441--><p class="nopar" > +<!--l. 1443--><p class="indent" > W części <a +href="#x1-630008.1.5">8.1.5<!--tex4ht:ref: sec:brace-expansion --></a> opisano dokładniej analizę listy katalogów umieszczonych w klamrach. +<!--l. 1446--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">3.4.7. </span> <a + id="x1-390003.4.7"></a>Integracja fontów z innych źródeł</h5> +<!--l. 1448--><p class="noindent" >Jest to, niestety, bardzo skomplikowane zagadnienie, wymagające sporej wiedzy użytkownika. Warto najpierw +się dowiedzieć, jakie fonty mamy dostępne bezpłatnie (patrz część <a +href="#x1-150002.7">2.7<!--tex4ht:ref: sec:tl-fonts --></a>). +<!--l. 1452--><p class="indent" > Alternatywą jest tu użycie programu Xe<span class="TEX">T<span +class="E">E</span>X</span> lub Lua<span class="TEX">T<span +class="E">E</span>X</span> (patrz część <a +href="#x1-120002.4">2.4<!--tex4ht:ref: sec:tex-extensions --></a>), które korzystają z fontów +systemowych bez potrzeby instalowania ich dla programów <span class="TEX">T<span +class="E">E</span>X</span>-owych. +<!--l. 1456--><p class="indent" > Procedury instalacji i integracji fontów opisano dokładnie np. w: <a +href="http://tug.org/fonts/fontinstall.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/fonts/fontinstall.html</span></a>. +<!--l. 1461--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">3.5. </span> <a + id="x1-400003.5"></a>Testowanie instalacji</h4> +<!--l. 1464--><p class="noindent" >Po zainstalowaniu <span class="TEX">T<span +class="E">E</span>X</span> Live warto sprawdzić, czy programy działają poprawnie. Opiszemy tu podstawowe +procedury testujące funkcjonowanie systemu w systemach Unix. W Mac OS X i Windows najczęściej użyjemy +środowiska graficznego (GUI), reguły jednak będą podobne. +<!--l. 1469--><p class="indent" > + <ol class="enumerate1" > + <li + class="enumerate" id="x1-40002x1">Sprawdzamy najpierw, czy uruchamia się program <span +class="ec-lmss-10">tex</span>: + <div class="alltt"> + <!--l. 1472--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tex</span><span +class="ec-lmtk-10"> --version</span> + <br /><span +class="ec-lmtt-10">TeX</span><span +class="ec-lmtt-10"> 3.1415926</span><span +class="ec-lmtt-10"> (TeX</span><span +class="ec-lmtt-10"> Live</span><span +class="ec-lmtt-10"> ...)</span> + <br /><span +class="ec-lmtt-10">kpathsea</span><span +class="ec-lmtt-10"> version</span><span +class="ec-lmtt-10"> 6.0.1</span> + <br /><span +class="ec-lmtt-10">Copyright</span><span +class="ec-lmtt-10"> ...</span><span +class="ec-lmtt-10"> D.E.</span><span +class="ec-lmtt-10"> Knuth.</span> + <br /><span +class="ec-lmtt-10">...</span> +</div> + </div> Jeśli uruchomienie kończy się komunikatem <span +class="ec-lmri-10">command not found </span>(<span +class="ec-lmri-10">nie znaleziono polecenia</span>), oznacza to, + że niepoprawnie zadeklarowano zmienną <span +class="ec-lmtt-10">PATH </span>(patrz: deklaracje zmiennych środowiska na + str. <a +href="#x1-330003.4.1">38<!--tex4ht:ref: sec:env --></a>). + </li> + <li + class="enumerate" id="x1-40004x2">Następnie przetwarzamy prosty plik <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>-owy: <div class="alltt"> + <!--l. 1485--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">latex</span><span +class="ec-lmtk-10"> sample2e.tex</span> + <br /><span +class="ec-lmtt-10">pdfTeX</span><span +class="ec-lmtt-10"> 3.1415926-...</span><span +class="ec-lmtt-10"> (TeX</span><span +class="ec-lmtt-10"> Live</span><span +class="ec-lmtt-10"> ...)</span> + <br /><span +class="ec-lmtt-10">.....</span> + <br /><span +class="ec-lmtt-10">Output</span><span +class="ec-lmtt-10"> written</span><span +class="ec-lmtt-10"> on</span><span +class="ec-lmtt-10"> sample2e.dvi</span><span +class="ec-lmtt-10"> (3</span><span +class="ec-lmtt-10"> pages,</span><span +class="ec-lmtt-10"> 7484</span><span +class="ec-lmtt-10"> bytes).</span> + <br /><span +class="ec-lmtt-10">Transcript</span><span +class="ec-lmtt-10"> written</span><span +class="ec-lmtt-10"> on</span><span +class="ec-lmtt-10"> sample2e.log.</span> +</div> + </div> Gdy program nie znajduje <span +class="ec-lmtt-10">sample2e.tex </span>(bądź innych wymaganych plików), może to oznaczać, że + nadal działają ustawienia zmiennych środowiska bądź pliki konfiguracyjne z innej (poprzedniej) + instalacji. Szczegółową analizę, gdzie pliki są szukane i znajdowane, umożliwia diagnostyka opisana + w części <a +href="#x1-700008.2.4">8.2.4<!--tex4ht:ref: sec:debugging --></a> na str. <a +href="#x1-700008.2.4">73<!--tex4ht:ref: sec:debugging --></a>. + </li> + <li + class="enumerate" id="x1-40006x3">Podgląd wyniku składu: <div class="alltt"> + + + <!--l. 1500--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10"> ></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">xdvi</span><span +class="ec-lmtk-10"> sample2e.dvi</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> #</span><span +class="ec-lmtt-10"> Unix</span> + <br /><span +class="ec-lmtt-10"> ></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">dviout</span><span +class="ec-lmtk-10"> sample2e.dvi</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> #</span><span +class="ec-lmtt-10"> Windows</span> +</div> + </div> Polecenie <span +class="ec-lmss-10">xdvi </span>wymaga uruchomionego środowiska graficznego X Window. Dla MS Windows + analogicznym poleceniem jest <span +class="ec-lmss-10">dviout</span>. + </li> + <li + class="enumerate" id="x1-40008x4">Przetwarzanie wyniku składu do PostScript w celu wyświetlenia lub wydruku: <div class="alltt"> + <!--l. 1514--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">dvips</span><span +class="ec-lmtk-10"> sample2e.dvi</span><span +class="ec-lmtk-10"> -o</span><span +class="ec-lmtk-10"> sample2e.ps</span> +</div> + </div> + </li> + <li + class="enumerate" id="x1-40010x5">Tworzenie dokumentu bezpośrednio w formacie PDF: <div class="alltt"> + <!--l. 1519--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">pdflatex</span><span +class="ec-lmtk-10"> sample2e.tex</span> +</div> + </div> + </li> + <li + class="enumerate" id="x1-40012x6">Podgląd dokumentu PDF: <div class="alltt"> + <!--l. 1524--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">gv</span><span +class="ec-lmtk-10"> sample2e.pdf</span> + <br />lub: + <br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">xpdf</span><span +class="ec-lmtk-10"> sample2e.pdf</span> +</div> + </div> Programy <span +class="ec-lmss-10">gv </span>i <span +class="ec-lmss-10">xpdf </span>są zwykle dostarczane w ramach systemu operacyjnego, wobec tego nie + zamieszczono ich na <span class="TEX">T<span +class="E">E</span>X</span> Live. Przed samodzielną instalacją warto odwiedzić strony, odpowiednio: + <a +href="http://www.gnu.org/software/gv" class="url" ><span +class="ec-lmtt-10">http://www.gnu.org/software/gv</span></a> i <a +href="http://www.foolabs.com/xpdf" class="url" ><span +class="ec-lmtt-10">http://www.foolabs.com/xpdf</span></a>. W sieci dostępny jest także + bezpłatny program Adobe Reader (<a +href="http://www.adobe.com" class="url" ><span +class="ec-lmtt-10">http://www.adobe.com</span></a>). Użytkownikom Windows można + zarekomendować program Sumatra PDF (<a +href="http://blog.kowalczyk.info/software/sumatrapdf" class="url" ><span +class="ec-lmtt-10">http://blog.kowalczyk.info/software/sumatrapdf</span></a>. + W systemie Windows domyślnie instalowany jest dla <span class="TEX">T<span +class="E">E</span>X</span> Live program <span +class="ec-lmss-10">psv </span>(PS_View), pozwalający + przeglądać pliki <span +class="ec-lmss-10">.ps </span>i <span +class="ec-lmss-10">.pdf</span>. Program ten można też zainstalować samodzielnie w systemach Linux + (<a +href="http://psview.sourceforge.net/download.html" class="url" ><span +class="ec-lmtt-10">http://psview.sourceforge.net/download.html</span></a>). + </li> + <li + class="enumerate" id="x1-40014x7">Inne przydatne pliki testowe: + <!--l. 1546--><p class="noindent" > + <dl class="list2"><dt class="list"> + <span +class="ec-lmtt-10">small2e.tex</span> </dt><dd +class="list"> + <!--l. 1547--><p class="noindent" >przykład prostszy niż <span +class="ec-lmtt-10">sample2e</span>; + </dd><dt class="list"> + <span +class="ec-lmtt-10">testpage.tex</span> </dt><dd +class="list"> + <!--l. 1548--><p class="noindent" >test położenia wydruku na kartce papieru, przydatny do sprawdzenia, czy nasza drukarka + nie wprowadza przesunięć; + + + </dd><dt class="list"> + <span +class="ec-lmtt-10">nfssfont.tex</span> </dt><dd +class="list"> + <!--l. 1550--><p class="noindent" >służy do wydruku tablic fontowych; + </dd><dt class="list"> + <span +class="ec-lmtt-10">testfont.tex</span> </dt><dd +class="list"> + <!--l. 1551--><p class="noindent" >jak wyżej, z tym że zamiast <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>-a trzeba użyć plain <span class="TEX">T<span +class="E">E</span>X</span>; + </dd><dt class="list"> + <span +class="ec-lmtt-10">story.tex</span> </dt><dd +class="list"> + <!--l. 1553--><p class="noindent" >najbardziej kanoniczny przykład dla plain <span class="TEX">T<span +class="E">E</span>X</span>; na zakończenie przetwarzania + uruchomionego poleceniem „<span +class="ec-lmtt-10">tex story</span>”, po ukazaniu się <span +class="ec-lmtt-10">*</span>, należy wpisać „<span +class="ec-lmtt-10">\bye</span>”.</dd></dl> + </li> + <li + class="enumerate" id="x1-40016x8">Jeśli zainstalowano pakiet <span +class="ec-lmtt-10">xetex</span>, możemy przetestować użycie fontów systemowych: <div class="alltt"> + <!--l. 1560--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">xetex</span><span +class="ec-lmtk-10"> opentype-info.tex</span> + <br /><span +class="ec-lmtt-10">This</span><span +class="ec-lmtt-10"> is</span><span +class="ec-lmtt-10"> XeTeX,</span><span +class="ec-lmtt-10"> Version</span><span +class="ec-lmtt-10"> 3.1415926</span><span +class="ec-lmtt-10">…</span> + <br /><span +class="ec-lmtt-10">...</span> + <br /><span +class="ec-lmtt-10">Output</span><span +class="ec-lmtt-10"> written</span><span +class="ec-lmtt-10"> on</span><span +class="ec-lmtt-10"> opentype-info.pdf</span><span +class="ec-lmtt-10"> (1</span><span +class="ec-lmtt-10"> page).</span> + <br /><span +class="ec-lmtt-10">Transcript</span><span +class="ec-lmtt-10"> written</span><span +class="ec-lmtt-10"> on</span><span +class="ec-lmtt-10"> opentype-info.log.</span> +</div> + </div> Gdy otrzymamy komunikat błędu: „Invalid fontname ‘Latin Modern Roman/ICU’…”, oznacza to, że + należy zmienić konfigurację, jak to opisano w części <a +href="#x1-360003.4.4">3.4.4<!--tex4ht:ref: sec:font-conf-sys --></a>. + </li></ol> +<!--l. 1574--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">3.6. </span> <a + id="x1-410003.6"></a>Programy pomocnicze dla Windows</h4> +<!--l. 1576--><p class="noindent" >Początkującym użytkownikom polecamy stronę <a +href="http://tug.org/begin.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/begin.html</span></a> oraz podręcznik Petera Flynna +<span +class="ec-lmri-10">Formatting Information</span>, dostępny pod adresem <a +href="http://www.ctan.org/tex-archive/documentation/beginlatex" class="url" ><span +class="ec-lmtt-10">http://www.ctan.org/tex-archive/documentation/beginlatex</span></a>. +<!--l. 1581--><p class="indent" > Aby instalacja była kompletna, <span class="TEX">T<span +class="E">E</span>X</span> Live wymaga kilku pomocniczych programów, które nie są +dostarczane 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. Ponadto posiadanie edytora zorientowanego na +środowisko <span class="TEX">T<span +class="E">E</span>X</span> znacznie ułatwi pracę. +<!--l. 1589--><p class="indent" > Wszystkie te programy dla Windows można dosyć łatwo znaleźć w sieci, ponieważ jednak jest ich spory +wybór, postanowiliśmy te najbardziej istotne umieścić w dystrybucji <span class="TEX">T<span +class="E">E</span>X</span> Live: + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">Perl i Ghostscript</span> </dt><dd +class="description">– obydwa te programy są niezbędne do poprawnego działania <span class="TEX">T<span +class="E">E</span>X</span> Live, + dołączyliśmy zatem <span +class="ec-lmss-10">Ghostscript </span>8.62 i minimalną dystrybucję <span +class="ec-lmss-10">Perl </span>5.8, wystarczającą do + uruchomienia wszystkich zawartych w <span class="TEX">T<span +class="E">E</span>X</span> Live skryptów perlowych; oba programy zostały + „ukryte”, to znaczy tylko programy <span class="TEX">T<span +class="E">E</span>X</span> Live, które z nich korzystają, „wiedzą” gdzie je znaleźć; + tym samym nie powinny kolidować z ewentualnie zainstalowanymi w systemie programami Perl + i Ghostscript; + </dd><dt class="description"> +<span +class="ec-lmbx-10">narzędzia uruchamiane z</span><span +class="ec-lmbx-10"> linii polece</span><span +class="ec-lmbx-10">ń</span> </dt><dd +class="description">– zestaw kilku przydatnych programów (<span +class="ec-lmtt-10">gzip</span>, <span +class="ec-lmtt-10">unzip</span>, + <span +class="ec-lmtt-10">jpeg2ps </span>i <span +class="ec-lmtt-10">tiff2png</span>) a także kilka narzędzi z zestawu <span +class="ec-lmss-10">xpdf</span>, uruchamianych z linii poleceń (sam + <span +class="ec-lmss-10">xpdf </span>nie jest dostępny dla Windows, można jednak pobrać z internetu opartą na nim przeglądarkę + PDF: <a +href="http://blog.kowalczyk.info/software/sumatrapdf" class="url" ><span +class="ec-lmtt-10">http://blog.kowalczyk.info/software/sumatrapdf</span></a>); + </dd><dt class="description"> +<span +class="ec-lmbx-10">fc-list, fc-cache</span> </dt><dd +class="description">– narzędzia z biblioteki fontconfig; program <span +class="ec-lmss-10">fc-cache </span>rejestruje dla Xe<span class="TEX">T<span +class="E">E</span>X</span>-a + fonty systemowe lub dostarczane w dystrybucji <span class="TEX">T<span +class="E">E</span>X</span> Live fonty OpenType; <span +class="ec-lmss-10">fc-list </span>wyświetla + zarejestrowane fonty, podając ich pełne nazwy (deklarujemy je w rozszerzonym w Xe<span class="TEX">T<span +class="E">E</span>X</span>-u + poleceniu <span +class="ec-lmtt-10">\font</span>); + + + </dd><dt class="description"> +<span +class="ec-lmbx-10">PS_View</span> </dt><dd +class="description">– program do podglądu plików postscriptowych (a także plików PDF), patrz rys. <a +href="#x1-41001r8">8<!--tex4ht:ref: fig:psview --></a>.</dd></dl> +<!--l. 1623--><p class="indent" > <hr class="figure"><div class="figure" +> + + +<a + id="x1-41001r8"></a> + + +<div class="center" +> +<!--l. 1624--><p class="noindent" > + +<!--l. 1625--><p class="noindent" ><img +src="../texlive-common/psview.png" alt="pict" +> +<br /> <div class="caption" +><span class="id">Rysunek 8: </span><span +class="content">PS_View: umożliwia bardzo duże powiększenia!</span></div><!--tex4ht:label?: x1-41001r8 --> +</div> + + +<!--l. 1628--><p class="indent" > </div><hr class="endfigure"> +<!--l. 1630--><p class="indent" > Poniżej zamieszczono listę miejsc, z których można pobrać programy pomocnicze: + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">Ghostscript</span> </dt><dd +class="description"><a +href="http://www.cs.wisc.edu/~ghost/" class="url" ><span +class="ec-lmtt-10">http://www.cs.wisc.edu/~ghost/</span></a> + </dd><dt class="description"> +<span +class="ec-lmbx-10">Perl</span> </dt><dd +class="description"><a +href="http://www.perl.org" class="url" ><span +class="ec-lmtt-10">http://www.perl.org</span></a> (uzupełniające, przydatne pakiety należy pobrać z zasobów CPAN + <a +href="http://cpan.org" class="url" ><span +class="ec-lmtt-10">http://cpan.org</span></a>) + </dd><dt class="description"> +<span +class="ec-lmbx-10">ImageMagick</span> </dt><dd +class="description">– bogaty zestaw narzędzi do wsadowego przetwarzania plików graficznych + (<a +href="http://www.imagemagick.com" class="url" ><span +class="ec-lmtt-10">http://www.imagemagick.com</span></a>) + </dd><dt class="description"> +<span +class="ec-lmbx-10">NetPBM</span> </dt><dd +class="description">– do przetwarzania i konwersji plików graficznych możemy użyć alternatywnego dla + <span +class="ec-lmss-10">ImageMagick </span>programu NetPBM (<a +href="http://netpbm.sourceforge.net/" class="url" ><span +class="ec-lmtt-10">http://netpbm.sourceforge.net/</span></a>) + </dd><dt class="description"> +<span +class="ec-lmbx-10">Edytory dla systemu </span><span class="TEX"><span +class="ec-lmbx-10">T</span><span +class="E"><span +class="ec-lmbx-10">E</span></span><span +class="ec-lmbx-10">X</span></span> </dt><dd +class="description">– spory wybór programów, uwzględniających indywidualne preferencje + użytkownika (poniżej wymieniono jedynie te działające w systemach Windows) + <ul class="itemize1"> + <li class="itemize"><span +class="ec-lmss-10">GNU Emacs </span>– w wersji zintegrowanej z <span +class="ec-lmss-10">AucTeX </span>dla Windows dostępny jest w archiwach + CTAN; strona domowa: <a +href="http://www.gnu.org/software/auctex" class="url" ><span +class="ec-lmtt-10">http://www.gnu.org/software/auctex</span></a>. + </li> + <li class="itemize"><span +class="ec-lmss-10">LEd </span>– polski edytor, dostępny z <a +href="http://mirror.ctan.org/support/LEd" class="url" ><span +class="ec-lmtt-10">http://mirror.ctan.org/support/LEd</span></a>. + </li> + <li class="itemize"><span +class="ec-lmss-10">SciTE </span>– edytor dostępny z <a +href="http://www.scintilla.org/SciTE.html" class="url" ><span +class="ec-lmtt-10">http://www.scintilla.org/SciTE.html</span></a> + </li> + <li class="itemize"><span +class="ec-lmss-10">Texmaker </span>– edytor dostępny z <a +href="http://www.xm1math.net/texmaker" class="url" ><span +class="ec-lmtt-10">http://www.xm1math.net/texmaker</span></a>. + </li> + <li class="itemize"><span +class="ec-lmss-10">TexMakerX </span>jest rozszerzeniem <span +class="ec-lmss-10">Texmaker </span>(<a +href="http://texmakerx.sourceforge.net" class="url" ><span +class="ec-lmtt-10">http://texmakerx.sourceforge.net</span></a>). + </li> + <li class="itemize">TeXnicCenter – kolejny, dosyć bogaty w funkcje edytor + (<a +href="http://www.toolscenter.org/products/texniccenter/" class="url" ><span +class="ec-lmtt-10">http://www.toolscenter.org/products/texniccenter/</span></a>) + </li> + <li class="itemize"><span +class="ec-lmss-10">TeXworks </span>– nowy edytor, dostępny z <a +href="http://tug.org/texworks" class="url" ><span +class="ec-lmtt-10">http://tug.org/texworks</span></a> i instalowany w Windows + oraz Mac OS X jako część <span class="TEX">T<span +class="E">E</span>X</span> Live. + </li> + <li class="itemize"><span +class="ec-lmss-10">Vim </span>– rozbudowany i bardzo funkcjonalny edytor, wywodzący się z klasycznego dla + systemów Unix edytora <span +class="ec-lmss-10">vi </span>(<a +href="http://www.vim.org" class="url" ><span +class="ec-lmtt-10">http://www.vim.org</span></a>) + </li> + <li class="itemize"><span +class="ec-lmss-10">WinShell </span>– prosty edytor/shell (<a +href="http://www.winshell.de" class="url" ><span +class="ec-lmtt-10">http://www.winshell.de</span></a>) + </li> + <li class="itemize"><span +class="ec-lmss-10">WinEdt </span>– bogaty w funkcje edytor dla <span class="TEX">T<span +class="E">E</span>X</span>-a, dostępny jako <span +class="ec-lmri-10">shareware</span> + (<a +href="http://www.winedt.com" class="url" ><span +class="ec-lmtt-10">http://www.winedt.com</span></a>)</li></ul> + </dd></dl> +<!--l. 1676--><p class="indent" > Obszerniejszą listę programów można znaleźć na stronie <a +href="http://tug.org/interest.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/interest.html</span></a>. + <h3 class="sectionHead"><span class="titlemark">4. </span> <a + id="x1-420004"></a>Instalacje zaawansowane</h3> +<!--l. 1681--><p class="noindent" >W poprzednich częściach opisano proces typowej instalacji. Teraz omówimy te bardziej wyspecjalizowane. +<!--l. 1684--><p class="indent" > <a id="tlsharedinstall"></a> + <h4 class="subsectionHead"><span class="titlemark">4.1. </span> <a + id="x1-430004.1"></a>Instalacje dla wielu użytkowników (lub wieloplatformowe)</h4> + + +<!--l. 1688--><p class="noindent" ><span class="TEX">T<span +class="E">E</span>X</span> Live zaprojektowano tak, by w sieci komputerowej mogło z niego korzystać wielu użytkowników, nawet +w różnych systemach operacyjnych. Dzięki standardowej strukturze katalogów nie ma potrzeby konfiguracji +i określania konkretnych ścieżek: położenie plików wymaganych przez programy <span class="TEX">T<span +class="E">E</span>X</span> Live jest zdefiniowane +jako względne wobec samych programów. Można to zobaczyć w pliku <span +class="ec-lmtt-10">$TEXMFMAIN/web2c/texmf.cnf</span>, który +zawiera np. takie wiersze: + <div class="fancyvrb" id="fancyvrb10"><a + id="x1-43002r1"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> TEXMFMAIN</span><span +class="ec-lmtt-9"> =</span><span +class="ec-lmtt-9"> $SELFAUTOPARENT/texmf</span><br class="fancyvrb" /><a + id="x1-43004r2"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> ...</span><br class="fancyvrb" /><a + id="x1-43006r3"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> TEXMFLOCAL</span><span +class="ec-lmtt-9"> =</span><span +class="ec-lmtt-9"> $SELFAUTOPARENT/../texmf-local</span></div> +<!--l. 1700--><p class="noindent" >W konsekwencji oznacza to, że dla różnych systemów operacyjnych bądź użytkowników wystarczy dodać do ich +ścieżek przeszukiwania tylko ścieżkę do programów <span class="TEX">T<span +class="E">E</span>X</span> Live. +<!--l. 1704--><p class="indent" > Możliwa jest zatem np. instalacja lokalna <span class="TEX">T<span +class="E">E</span>X</span> Live, po czym przeniesienie całej struktury w inne miejsce +w sieci. +<!--l. 1707--><p class="indent" > Użytkownicy Windows mogą pobrać z internetu skrypt <span +class="ec-lmtt-10">w32client </span>(patrz: <a +href="http://tug.org/texlive/w32client.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/w32client.html</span></a>), +który pozwala dostosować istniejącą instalację <span class="TEX">T<span +class="E">E</span>X</span> Live dla potrzeb sieci (włącznie z utworzeniem skrótów +w menu systemowym). Plik .zip dostępny na wymienionej stronie zawiera ponadto skrypt <span +class="ec-lmtt-10">w32unclient</span>, +służący do odinstalowania. +<!--l. 1718--><p class="indent" > <a id="tlportable"></a> + <h4 class="subsectionHead"><span class="titlemark">4.2. </span> <a + id="x1-440004.2"></a>Przenośna instalacja na pen drivie USB</h4> +<!--l. 1722--><p class="noindent" >Aby wykonać przenośną instalację na pen drivie należy uruchomić program instalacyjny z opcją <span +class="ec-lmtt-10">-portable</span> +(lub polecenie <span +class="ec-lmtt-10">V </span>w trybie tekstowym bądź odpowiednia opcja w trybie GUI). Instalacja taka nie ingeruje w +sam system operacyjny. Można ją wykonać bezpośrednio na pen drivie, lub na dysku twardym, skąd +kopiujemy ją na urządzenie przenośne. +<!--l. 1728--><p class="indent" > Do uruchomienia programów <span class="TEX">T<span +class="E">E</span>X</span> Live w takiej instalacji wystarczy w sesji terminala dodać, jak +zazwyczaj, odpowiedni katalog do zmiennej <span +class="ec-lmtt-10">PATH</span>. W Windows należy dwukrotnie kliknąć <span +class="ec-lmtt-10">tl-tray-menu </span>w +głównym katalogu instalacji, aby wybrać jedno z podstawowych zadań, pokazanych na poniższym +rysunku: + +<!--l. 1735--><p class="indent" > <img +src="../texlive-common/tray-menu.png" alt="pict" +> +<!--l. 1738--><p class="noindent" >Wybór „More…” pokaże komunikat z informacją jak można dostosować menu do własnych potrzeb. +<!--l. 1741--><p class="indent" > <a id="tlisoinstall"></a> + <h4 class="subsectionHead"><span class="titlemark">4.3. </span> <a + id="x1-450004.3"></a>Instalacje z pliku obrazu ISO (lub DVD)</h4> +<!--l. 1745--><p class="noindent" >Jeśli nie zamierzamy często aktualizować bądź modyfikować w inny sposób naszej instalacji, a także gdy +zamierzamy uruchamiać <span class="TEX">T<span +class="E">E</span>X</span> Live na wielu systemach, warto utworzyć plik obrazu ISO takiej instalacji, +choćby z poniższych powodów: + <ul class="itemize1"> + <li class="itemize">kopiowanie obrazu ISO między komputerami jest znacznie szybsze niż kopiowanie zwykłej + instalacji; + </li> + <li class="itemize">jeśli używamy kilku systemów operacyjnych na tym samym komputerze i chcemy korzystać z tej + samej instalacji <span class="TEX">T<span +class="E">E</span>X</span> Live, obraz ISO instalacji jest pozbawiony ograniczeń różnych systemów + plików (FAT32, NTFS, HFS+); + </li> + <li class="itemize">systemy uruchamiane w trybie wirtualnym mogą po prostu zamontować plik obrazu ISO.</li></ul> +<!--l. 1761--><p class="indent" > Obraz ISO można oczywiście wypalić na płytce DVD. +<!--l. 1763--><p class="indent" > Systemy GNU/Linux/Unix (w tym Mac OS X) pozwalają na montowanie pliku obrazu ISO. Prócz tego taka +instalacja w niczym się nie różni od typowej, wykonanej na dysku (patrz: <a +href="#x1-330003.4.1">3.4.1<!--tex4ht:ref: sec:env --></a>). +<!--l. 1767--><p class="indent" > Podczas wykonywania instalacji do ISO warto pominąć specyfikowanie katalogu dla roku wydania, +ponadto warto umieścić katalog <span +class="ec-lmtt-10">texmf-local </span>na tym samym poziomie co inne drzewa (<span +class="ec-lmtt-10">texmf</span>, <span +class="ec-lmtt-10">texmf-dist</span>, +itd.). Zmianę katalogów umożliwia opcja <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">TEXDIR</span></span></span> programu instalacyjnego. +<!--l. 1772--><p class="indent" > Dla natywnego (nie wirtualnego) systemu Windows można wypalić obraz ISO na płytce DVD, ale warto +też rozważyć instalację któregoś z dostępnych w sieci programów umożliwiających montowanie takiego +obrazu. Np. dla Windows XP Microsoft oferuje program <span +class="ec-lmtt-10">winxpvirtualcdcontrolpanel</span>. + + +<!--l. 1777--><p class="indent" > Poza tym w Windows można dołączyć opisany wyżej skrypt <span +class="ec-lmtt-10">w32client </span>(patrz: <a +href="#x1-430004.1">4.1<!--tex4ht:ref: sec:sharedinstall --></a> oraz +<a +href="http://tug.org/texlive/w32client.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/w32client.html</span></a>), który wykonuje swe zadania, podobnie jak w wypadku instalacji +sieciowej. +<!--l. 1782--><p class="indent" > W systemie Mac OS X programy TeXShop i <span class="TEX">T<span +class="E">E</span>X</span>works będą mogły wykorzystać instalację +na DVD, gdy zadeklarujemy dowiązanie symboliczne <span +class="ec-lmtt-10">/usr/texbin </span>do odpowiedniego katalogu, +np.: + + + <div class="verbatim" id="verbatim-2"> + <div class="fancyvrb" id="fancyvrb11"><a + id="x1-45002r1"></a>  sudo ln -s /Volumes/MyTeXLive/bin/universal-darwin /usr/texbin</div> +</div> +<!--l. 1787--><p class="nopar" > +<!--l. 1789--><p class="indent" > Uwaga historyczna: <span class="TEX">T<span +class="E">E</span>X</span> Live 2010 był pierwszą edycją, która (z różnych przyczyn) nie była faktycznie +<span +class="ec-lmri-10">live</span>. Niemniej jednak poprzednie edycje zawsze wymagały akrobatycznych „sztuczek” do uruchamiania +programów bezpośrednio z DVD lub obrazu ISO (np. deklarowania dodatkowej zmiennej środowiska). Obraz +ISO, tworzony obecnie, tego nie wymaga. +<!--l. 1795--><p class="indent" > <a id="tlmgr"></a> + <h3 class="sectionHead"><span class="titlemark">5. </span> <a + id="x1-460005"></a><span +class="ec-lmss-10">tlmgr</span>: zarządzanie instalacją</h3> +<!--l. 1799--><p class="noindent" ><span class="TEX">T<span +class="E">E</span>X</span> Live zawiera program o nazwie <span +class="ec-lmss-10">tlmgr</span>, służący do dalszego zarządzania <span class="TEX">T<span +class="E">E</span>X</span> Live po pierwotnej +instalacji. Programy <span +class="ec-lmss-10">updmap</span>, <span +class="ec-lmss-10">fmtutil </span>oraz <span +class="ec-lmss-10">texconfig </span>są nadal dostępne i będą utrzymywane w przyszłości, +jednakże obecnie polecanym interfejsem jest <span +class="ec-lmss-10">tlmgr</span>. Jego możliwości obejmują: + <ul class="itemize1"> + <li class="itemize">instalowanie, aktualizację, tworzenie kopii zapasowych, odtwarzanie oraz usuwanie pojedynczych + pakietów (opcjonalnie – z uwzględnieniem zależności pomiędzy pakietami); + </li> + <li class="itemize">wyszukiwanie i pokazanie zawartości pakietów; + </li> + <li class="itemize">wyszczególnianie oraz dodawanie architektur (platform systemowych); + </li> + <li class="itemize">zmianę opcji instalacji, takich jak rozmiar papieru czy zmiana położenia źródła instalacji (patrz + część <a +href="#x1-310003.3.1">3.3.1<!--tex4ht:ref: sec:location --></a>).</li></ul> +<!--l. 1815--><p class="indent" > <hr class="figure"><div class="figure" +> + + +<a + id="x1-46001r9"></a> + + + +<!--l. 1816--><p class="noindent" ><img +src="../texlive-common/tlmgr-gui.png" alt="pict" +> +<br /> <div class="caption" +><span class="id">Rysunek 9: </span><span +class="content"><span +class="ec-lmss-10">tlmgr </span>w trybie graficznym: główne okno, po akcji „Wczytaj” (<span +class="ec-lmri-10">Load</span>).</span></div><!--tex4ht:label?: x1-46001r9 --> + + +<!--l. 1820--><p class="indent" > </div><hr class="endfigure"> +<!--l. 1822--><p class="indent" > <hr class="figure"><div class="figure" +> + + +<a + id="x1-46002r10"></a><a + id="x1-46003r11"></a> + + + +<!--l. 1826--><p class="noindent" ><img +src="../texlive-common/tlmgr-general-options.png" alt="pict" +> +<br /> <div class="caption" +><span class="id">Rysunek 10: </span><span +class="content"><span +class="ec-lmtt-10">tlmgr </span>w trybie GUI: Opcje ogólne</span></div><!--tex4ht:label?: x1-46002r10 --> +<!--l. 1833--><p class="noindent" ><img +src="../texlive-common/tlmgr-paper-options.png" alt="pict" +> +<br /> <div class="caption" +><span class="id">Rysunek 11: </span><span +class="content"><span +class="ec-lmtt-10">tlmgr </span>w trybie GUI: +Opcje dotyczące formatu papieru</span></div><!--tex4ht:label?: x1-46003r11 --> + + +<!--l. 1838--><p class="indent" > </div><hr class="endfigure"> + <h4 class="subsectionHead"><span class="titlemark">5.1. </span> <a + id="x1-470005.1"></a><span +class="ec-lmss-10">tlmgr </span>– tryb graficzny (GUI)</h4> +<!--l. 1847--><p class="noindent" ><span +class="ec-lmss-10">tlmgr </span>może być uruchomiony w trybie graficznym (rys. <a +href="#x1-46001r9">9<!--tex4ht:ref: fig:tlmgr-gui --></a>) za pomocą polecenia: <div class="alltt"> +<!--l. 1849--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tlmgr</span><span +class="ec-lmtk-10"> -gui</span> +</div> +</div> zaś w systemie Windows poprzez wybór menu: <span +class="ec-lmtt-10">Start</span>, <span +class="ec-lmtt-10">Programy</span>, <span +class="ec-lmtt-10">TeX Live 2012</span>, <span +class="ec-lmtt-10">TeX Live</span> +<span +class="ec-lmtt-10">Manager</span>. Po kliknięciu przycisku „Wczytaj” wyświetla listę dostępnych oraz listę zainstalowanych +pakietów. +<!--l. 1860--><p class="indent" > Rysunki <a +href="#x1-46002r10">10<!--tex4ht:ref: fig:tlmgr-general-options --></a> i <a +href="#x1-46003r11">11<!--tex4ht:ref: fig:tlmgr-paper-options --></a> pokazują zakładki doczące opcji. +<!--l. 1863--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">5.2. </span> <a + id="x1-480005.2"></a>Przykładowe wywołania <span +class="ec-lmss-10">tlmgr </span>z linii poleceń</h4> +<!--l. 1865--><p class="noindent" >Po zainstalowaniu <span class="TEX">T<span +class="E">E</span>X</span> Live można dokonać aktualizacji wszystkich pakietów: <div class="alltt"> +<!--l. 1866--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tlmgr</span><span +class="ec-lmtk-10"> update</span><span +class="ec-lmtk-10"> -all</span> +</div> +</div> Symulację aktualizacji umożliwia: <div class="alltt"> +<!--l. 1870--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tlmgr</span><span +class="ec-lmtk-10"> update</span><span +class="ec-lmtk-10"> -all</span><span +class="ec-lmtk-10"> -dry-run</span> +</div> +</div> bądź tylko wyliczenie, jakie pakiety będą aktualizowane: <div class="alltt"> +<!--l. 1874--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tlmgr</span><span +class="ec-lmtk-10"> update</span><span +class="ec-lmtk-10"> -list</span> +</div> +</div> +<!--l. 1878--><p class="indent" > Poniższy przykład dodaje kolekcję zawierającą m.in. nowy „silnik” Xe<span class="TEX">T<span +class="E">E</span>X</span>, z lokalnego repozytorium +instalacji: + <div class="alltt"> +<!--l. 1882--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tlmgr</span><span +class="ec-lmtk-10"> -repository</span><span +class="ec-lmtk-10"> /local/mirror/tlnet</span><span +class="ec-lmtk-10"> install</span><span +class="ec-lmtk-10"> collection-xetex</span> +</div> +</div> co pokazują komunikaty (tu w skrócie): + <div class="fancyvrb" id="fancyvrb12"><a + id="x1-48002r1"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> collection-xetex</span><br class="fancyvrb" /><a + id="x1-48004r2"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> arabxetex</span><br class="fancyvrb" /><a + id="x1-48006r3"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> ...</span><br class="fancyvrb" /><a + id="x1-48008r4"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> xetex</span><br class="fancyvrb" /><a + id="x1-48010r5"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> xetexconfig</span> +<br class="fancyvrb" /><a + id="x1-48012r6"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> xetex.i386-linux</span><br class="fancyvrb" /><a + id="x1-48014r7"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> running</span><span +class="ec-lmtt-8"> post</span><span +class="ec-lmtt-8"> install</span><span +class="ec-lmtt-8"> action</span><span +class="ec-lmtt-8"> for</span><span +class="ec-lmtt-8"> xetex</span><br class="fancyvrb" /><a + id="x1-48016r8"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> install:</span><span +class="ec-lmtt-8"> xetex-def</span><br class="fancyvrb" /><a + id="x1-48018r9"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> ...</span><br class="fancyvrb" /><a + id="x1-48020r10"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> running</span><span +class="ec-lmtt-8"> mktexlsr</span> +<br class="fancyvrb" /><a + id="x1-48022r11"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> mktexlsr:</span><span +class="ec-lmtt-8"> Updating</span><span +class="ec-lmtt-8"> /usr/local/texlive/2012/texmf/ls-R...</span><br class="fancyvrb" /><a + id="x1-48024r12"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> ...</span><br class="fancyvrb" /><a + id="x1-48026r13"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> running</span><span +class="ec-lmtt-8"> fmtutil-sys</span><span +class="ec-lmtt-8"> --missing</span><br class="fancyvrb" /><a + id="x1-48028r14"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> ...</span> +<br class="fancyvrb" /><a + id="x1-48030r15"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Transcript</span><span +class="ec-lmtt-8"> written</span><span +class="ec-lmtt-8"> on</span><span +class="ec-lmtt-8"> xelatex.log.</span><br class="fancyvrb" /><a + id="x1-48032r16"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> fmtutil:</span><span +class="ec-lmtt-8"> /usr/local/texlive/2012/texmf-var/web2c/xetex/xelatex.fmt</span><span +class="ec-lmtt-8"> installed.</span></div> +<!--l. 1905--><p class="indent" > Jak widać, <span +class="ec-lmss-10">tlmgr </span>instaluje wszystkie pakiety zależne, a także przeprowadza wymagane czynności +poinstalacyjne, jak aktualizacja bazy danych, budowa plików formatów itp. (w przykładzie wygenerowaliśmy +nowy format dla Xe<span class="TEX">T<span +class="E">E</span>X</span>). +<!--l. 1910--><p class="indent" > Aby wyświetlić informację o pakiecie (kolekcji bądź schemacie), należy uruchomić np.: <div class="alltt"> +<!--l. 1912--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tlmgr</span><span +class="ec-lmtk-10"> show</span><span +class="ec-lmtk-10"> collection-latexextra</span> + + +</div> +</div> co pokaże: + <div class="fancyvrb" id="fancyvrb13"><a + id="x1-48034r1"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> package:</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> collection-latexextra</span><br class="fancyvrb" /><a + id="x1-48036r2"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> category:</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Collection</span><br class="fancyvrb" /><a + id="x1-48038r3"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> shortdesc:</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> LaTeX</span><span +class="ec-lmtt-8"> supplementary</span><span +class="ec-lmtt-8"> packages</span> +<br class="fancyvrb" /><a + id="x1-48040r4"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> longdesc:</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> A</span><span +class="ec-lmtt-8"> large</span><span +class="ec-lmtt-8"> collection</span><span +class="ec-lmtt-8"> of</span><span +class="ec-lmtt-8"> add-on</span><span +class="ec-lmtt-8"> packages</span><span +class="ec-lmtt-8"> for</span><span +class="ec-lmtt-8"> LaTeX.</span><br class="fancyvrb" /><a + id="x1-48042r5"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> installed:</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> Yes</span><br class="fancyvrb" /><a + id="x1-48044r6"></a><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> revision:</span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> </span><span +class="ec-lmtt-8"> 14675</span></div> +<!--l. 1925--><p class="noindent" ><span +class="ec-lmbx-10">Uwaga: </span>pełna dokumentacja programu <span +class="ec-lmss-10">tlmgr </span>dostępna jest pod adresem: <a +href="http://tug.org/texlive/tlmgr.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/tlmgr.html</span></a> +lub po uruchomieniu: <div class="alltt"> +<!--l. 1929--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">tlmgr</span><span +class="ec-lmtk-10"> -help</span> +</div> +</div> +<!--l. 1933--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">6. </span> <a + id="x1-490006"></a>Uwagi dotyczące Windows</h3> +<!--l. 1941--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">6.1. </span> <a + id="x1-500006.1"></a>Cechy specyficzne w systemie Windows</h4> +<!--l. 1944--><p class="noindent" >W systemie Windows program instalacyjny wykonuje kilka dodatkowych czynności: + <dl class="description"><dt class="description"> +<span +class="ec-lmbx-10">Menu i skr</span><span +class="ec-lmbx-10">óty.</span> </dt><dd +class="description">W menu systemowym instalowane jest podmenu „<span class="TEX">T<span +class="E">E</span>X</span> Live”, które zawiera + kilka pozycji dla programów działających w trybie graficznym (<span +class="ec-lmss-10">tlmgr</span>, <span +class="ec-lmss-10">texdoctk</span>, PS_View – + przeglądarka plików postscriptowych) oraz dokumentacji. + </dd><dt class="description"> +<span +class="ec-lmbx-10">Skojarzenia typ</span><span +class="ec-lmbx-10">ów plik</span><span +class="ec-lmbx-10">ów.</span> </dt><dd +class="description">Jeśli wybrano tę opcję, <span +class="ec-lmss-10">TeXworks</span>, <span +class="ec-lmss-10">Dviout </span>oraz <span +class="ec-lmss-10">PS_view </span>otwierają + domyślne dla tych programów typy plików (lub, przy kliknięciu prawym klawiszem myszy na + danym pliku, proponują „Otwórz” i wybór programu). + </dd><dt class="description"> +<span +class="ec-lmbx-10">Konwerter bitmap do EPS.</span> </dt><dd +class="description">Dla różnych formatów graficznych plików bitmapowych kliknięcie + prawym klawiszem myszy wyświetla w menu „Otwórz” <span +class="ec-lmss-10">bitmap2eps</span>. Bitmap2eps jest prostym + skryptem, który pozwala na wybór programu <span +class="ec-lmss-10">sam2p </span>bądź <span +class="ec-lmss-10">bmeps</span>. + </dd><dt class="description"> +<span +class="ec-lmbx-10">Automatyczne ustawienie zmiennych </span><span +class="ec-lmbx-10">środowiska.</span> </dt><dd +class="description">Po instalacji nie są wymagane żadne „ręczne” + zmiany ustawień. + </dd><dt class="description"> +<span +class="ec-lmbx-10">Odinstalowanie.</span> </dt><dd +class="description">Program instalacyjny rejestruje instalację w menu „Dodaj/Usuń programy” + w Panelu sterowania; odinstalowanie odbywa się zatem w standardowy dla Windows sposób.</dd></dl> +<!--l. 1982--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">6.2. </span> <a + id="x1-510006.2"></a>User Profile to inaczej Home (katalog domowy)</h4> +<!--l. 1985--><p class="noindent" >Odpowiednikiem uniksowego katalogu domowego użytkownika (<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">$HOME</span></span></span>) jest w Windows katalog określany +zmienną <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">%USERPROFILE%</span></span></span>. W Windows XP jest to zazwyczaj katalog <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">C:\Documents</span><span +class="ec-lmtt-10"> and</span><span +class="ec-lmtt-10"> Settings\</span></span></span> +<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10"><nazwa_u</span><span +class="ec-lmtt-10">żytkownika></span></span></span>, zaś w Windows Vista i Windows 7 katalog <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">C:\Users\<nazwa_u</span><span +class="ec-lmtt-10">żytkownika></span></span></span>. +W pliku konfiguracyjnym <span +class="ec-lmtt-10">texmf.cnf </span>i bibliotekach Kpathsea znak <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">~</span></span></span> jest poprawnie rozwijany do +odpowiedniej zmiennej zarówno w Windows, jak i w Unix/Linux. + + +<!--l. 1994--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">6.3. </span> <a + id="x1-520006.3"></a>Rejestr Windows</h4> +<!--l. 1997--><p class="noindent" >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 <span class="path"><span +class="ec-lmtt-10">HKEY_CURRENT_USER</span></span> oraz <span class="path"><span +class="ec-lmtt-10">HKEY_LOCAL_MACHINE</span></span> (w skrócie <span class="path"><span +class="ec-lmtt-10">HKCU</span></span> i <span class="path"><span +class="ec-lmtt-10">HKLM</span></span>). Część <span class="path"><span +class="ec-lmtt-10">HKCU</span></span> +dotyczy katalogów domowych użytkowników (patrz <a +href="#x1-510006.2">6.2<!--tex4ht:ref: sec:winhome --></a>), zaś <span class="path"><span +class="ec-lmtt-10">HKLM</span></span> – podkatalogów systemowych (w katalogu +Windows). +<!--l. 2005--><p class="indent" > Informacje o ustawieniach systemu można czasem uzyskać ze zmiennych środowiska, ale po inne +informacje, np. położenie tzw. skrótów, trzeba odwołać się do rejestru. Także zapis zmiennych środowiska na +stałe wymaga dostępu do rejestru. +<!--l. 2010--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">6.4. </span> <a + id="x1-530006.4"></a>Uprawnienia w Windows</h4> +<!--l. 2017--><p class="noindent" >W nowszych wersjach Windows istnieje wyraźne rozróżnienie między użytkownikami „zwykłymi” +i administratorami, mającymi pełną swobodę dostępu do całości systemu. Dołożono wielu starań, aby +umożliwić instalację <span class="TEX">T<span +class="E">E</span>X</span> Live także osobom bez uprawnień administratora. +<!--l. 2027--><p class="indent" > Jeśli osoba instalująca jest administratorem, to udostępniona jest opcja instalacji dla wszystkich +użytkowników. Użycie jej oznacza, że tworzone są skróty, a także ustawiane są zmienne środowiska dla całego +systemu. W przeciwnym wypadku skróty i menu są tworzone jedynie dla konkretnego użytkownika, także +definiowane zmienne środowiska dotyczą zwykłych użytkowników. +<!--l. 2037--><p class="indent" > Bez względu na status użytkownika proponowanym, domyślnym katalogiem głównym instalacji, jest +katalog w ramach <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">%SystemDrive%</span></span></span>. Program instalacyjny zawsze sprawdza, czy ten katalog jest dostępny do +zapisu dla aktualnego użytkownika. +<!--l. 2042--><p class="indent" > Problem może się pojawić wtedy, gdy użytkownik instalujący <span class="TEX">T<span +class="E">E</span>X</span> Live nie jest administratorem, +a programy <span class="TEX">T<span +class="E">E</span>X</span>-owe są już 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 nie będą znajdowane nowo instalowane +programy. Aby rozwiązać ten problem, program instalacyjny tworzy skrót do okna z wierszem poleceń, +w którym ścieżka do nowych programów <span class="TEX">T<span +class="E">E</span>X</span> Live ma priorytet. W ten sposób, po uruchomieniu tego +skrótu, będzie można korzystać z <span class="TEX">T<span +class="E">E</span>X</span> Live. Dotyczy to także programu <span class="TEX">T<span +class="E">E</span>X</span>works, o ile go +zainstalowaliśmy. +<!--l. 2051--><p class="indent" > Windows Vista i Windows 7 stwarzają dodatkowe utrudnienia: nawet jeśli jesteśmy zalogowani jako +administrator, musimy dodatkowo żądać uprawnień do uruchomienia programów jako administrator! +W rzeczywistości nie ma sensu logowanie jako administrator, zamiast tego wystarczy kliknąć +prawym klawiszem myszy na programie (lub skrócie), co pozwala wybrać opcję „Uruchom jako +administrator”. +<!--l. 2059--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">6.5. </span> <a + id="x1-540006.5"></a>Zwiększanie maksymalnej ilości dostępnej pamięci w Windows i Cygwin</h4> +<!--l. 2062--><p class="noindent" >Użytkownicy systemów Windows i Cygwin mogą w przypadku uruchamiania niektórych programów +dostarczonych w <span class="TEX">T<span +class="E">E</span>X</span> Live spotkać się z niewystarczającą ilością dostępnej pamięci. Na przykład <span +class="ec-lmss-10">asy</span> +wyczerpie dostępną pamięć w przypadku próby zadeklarowania macierzy składającej się z 25 milionów liczb +rzeczywistych, a Lua<span class="TEX">T<span +class="E">E</span>X</span> przy przetwarzaniu dokumentu zawierającego wiele dużych czcionek. +<!--l. 2070--><p class="indent" > W Cygwin można ten problem rozwiązać w sposób podany za poradą zawartą w Podręczniku +Użytkownika Cygwin (<a +href="http://www.cygwin.com/cygwin-ug-net/setup-maxmem.html" class="url" ><span +class="ec-lmtt-10">http://www.cygwin.com/cygwin-ug-net/setup-maxmem.html</span></a>). +<!--l. 2074--><p class="indent" > W Windows należy utworzyć plik, np. <span +class="ec-lmtt-10">moremem.reg</span>, o zawartości: + <div class="fancyvrb" id="fancyvrb14"><a + id="x1-54002r1"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> Windows</span><span +class="ec-lmtt-9"> Registry</span><span +class="ec-lmtt-9"> Editor</span><span +class="ec-lmtt-9"> Version</span><span +class="ec-lmtt-9"> 5.00</span><br class="fancyvrb" /><a + id="x1-54004r2"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><br class="fancyvrb" /><a + id="x1-54006r3"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> [HKEY_LOCAL_MACHINE\Software\Cygwin]</span><br class="fancyvrb" /><a + id="x1-54008r4"></a><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> "heap_chunk_in_mb"=dword:ffffff00</span></div> +<!--l. 2082--><p class="noindent" >a następnie wykonać (jako użytkownik z prawami administratora) polecenie: <span +class="ec-lmtt-10">regedit /s moremem.reg</span>. +Zamiast ustawień globalnych dla systemu, można też zmienić wielkość dostępnej pamięci jedynie dla +bieżącego użytkownika, używając <span +class="ec-lmtt-10">HKEY_CURRENT_USER</span>. +<!--l. 2087--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">7. </span> <a + id="x1-550007"></a>W razie problemów</h3> + + +<!--l. 2091--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">7.1. </span> <a + id="x1-560007.1"></a>Co zrobić gdy <span +class="ec-lmtt-10">latex </span>nie może znaleźć potrzebnych plików?</h4> + <ul class="itemize1"> + <li class="itemize">Podstawowym narzędziem do diagnozowania problemów jest program <span +class="ec-lmss-10">kpsewhich</span>. Wyprowadza on + informacje diagnostyczne na wyjście stderr, przy czym konsole (okienka wierszy poleceń) starszych + systemów Windows nie potrafią przekierować stderr do pliku. Umożliwia to dopiero system Windows NT + i późniejsze, ale rozwiązanie przedstawione poniżej działa dla każdej konsoli (okienka wierszy poleceń). + Otóż dla celów diagnostycznych można tymczasowo zdefiniować zmienną środowiska (w oknie + poleceń): + + + <div class="verbatim" id="verbatim-3"> + <div class="fancyvrb" id="fancyvrb15"><a + id="x1-56002r1"></a>  SET KPATHSEA_DEBUG_OUTPUT=err.log</div> +</div> + <!--l. 2103--><p class="nopar" >Można również zadać zakres diagnostyki: + + + <div class="verbatim" id="verbatim-4"> + <div class="fancyvrb" id="fancyvrb16"><a + id="x1-56004r1"></a>  SET KPATHSEA_DEBUG=-1</div> +</div> + <!--l. 2107--><p class="nopar" > + <!--l. 2109--><p class="noindent" >Podobnie, aby przekierować wyjście stderr na stdout: + + + <div class="verbatim" id="verbatim-5"> + <div class="fancyvrb" id="fancyvrb17"><a + id="x1-56006r1"></a>  SET KPATHSEA_DEBUG_OUTPUT=con:</div> +</div> + <!--l. 2112--><p class="nopar" >W ten sposób można skierować zarówno stderr, jak i stdout do tego samego pliku. + </li> + <li class="itemize">Przy założeniu, że instalację wykonano w <span class="path"><span +class="ec-lmtt-10">c:/TeX</span></span>, należy sprawdzić (porównać) następujące + wartości:<br +class="newline" /><!--tex4ht:inline--><div class="tabular"> <table id="TBL-2" class="tabular" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-2-1g"><col +id="TBL-2-1"><col +id="TBL-2-2"></colgroup><tr + style="vertical-align:baseline;" id="TBL-2-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-1-1" +class="td11"> <span class="path"><span +class="ec-lmtt-9">kpsewhich</span><span +class="ec-lmtt-9"> -expand-path</span><span +class="ec-lmtt-9"> $SELFAUTOPARENT</span></span> </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-1-2" +class="td11"> <span class="path"><span +class="ec-lmtt-9">c:/TeX</span></span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-2-1" +class="td11"> <span class="path"><span +class="ec-lmtt-9">kpsewhich</span><span +class="ec-lmtt-9"> -expand-path</span><span +class="ec-lmtt-9"> $TEXMF</span></span> </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-2-2" +class="td11"> <span class="path"><span +class="ec-lmtt-9">c:/TeX/texmf....</span></span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-3-1" +class="td11"> <span class="path"><span +class="ec-lmtt-9">kpsewhich</span><span +class="ec-lmtt-9"> -expand-var</span><span +class="ec-lmtt-9"> $TEXINPUTS</span></span> </td><td style="white-space:nowrap; text-align:left;" id="TBL-2-3-2" +class="td11"> <span class="path"><span +class="ec-lmtt-9">.;c:/TeX/texmf/tex//</span></span> </td></tr></table> + </div> + <!--l. 2124--><p class="noindent" >Jeśli w otoczeniu systemowym są zdefiniowane zmienne związane z <span class="TEX">T<span +class="E">E</span>X</span>-em, należy je usunąć, mają + bowiem pierwszeństwo przed tymi, które określono w pliku <span +class="ec-lmtt-10">texmf.cnf</span>. + </li> + <li class="itemize">Następnie należy sprawdzić (porównać) wartości:<br +class="newline" /><!--tex4ht:inline--><div class="tabular"> <table id="TBL-3" class="tabular" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-3-1g"><col +id="TBL-3-1"><col +id="TBL-3-2"></colgroup><tr + style="vertical-align:baseline;" id="TBL-3-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-1-1" +class="td11"> <span +class="ec-lmtt-9">kpsewhich cmr10.tfm </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-1-2" +class="td11"> <span class="path"><span +class="ec-lmtt-9">c:/TeX/texmf-dist/fonts/tfm/public/cm/cmr10.tfm</span></span> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-2-1" +class="td11"> <span +class="ec-lmtt-9">kpsewhich latex.fmt </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-2-2" +class="td11"> <span class="path"><span +class="ec-lmtt-9">c:/TeX/texmf-var/web2c/pdftex/latex.fmt</span></span> </td></tr></table> + </div> + <!--l. 2135--><p class="noindent" >Jeśli podczas sprawdzania nie znaleziono odstępstw, to <span class="TEX">T<span +class="E">E</span>X</span> i programy towarzyszące powinny działać. + Jeśli tak nie jest, to należy poeksperymentować z opcją <span class="path"><span +class="ec-lmtt-10">-debug=n</span></span> programu <span class="path"><span +class="ec-lmtt-10">kpsewhich</span></span> i zweryfikować + wszystkie uzyskane wartości. Po zidentyfikowaniu problemu warto go zgłosić.</li></ul> +<!--l. 2143--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">8. </span> <a + id="x1-570008"></a>Instrukcja obsługi systemu Web2C</h3> +<!--l. 2145--><p class="noindent" >Web2C to zestaw programów związanych z <span class="TEX">T<span +class="E">E</span>X</span>-em, tj. sam <span class="TEX">T<span +class="E">E</span>X</span>, Metafont, MetaPost, BibTeX itd. Stanowią +one rdzeń dystrybucji <span class="TEX">T<span +class="E">E</span>X</span> Live. +<!--l. 2148--><p class="indent" > Oryginalna implementacja wykonana została przez Tomasa Rokickiego, który w roku 1987 stworzył +pierwszy system <span class="TEX">T<span +class="E">E</span>X</span>-to-C, adaptując pliki wymiany (<span +class="ec-lmri-10">change files</span>) pod Unix-em (pierwotnie +były one dziełem Howarda Trickey’a oraz Pavela Curtisa). W czasie, gdy Tim Morgan zajmował +się systemem, jego nazwa została zmieniona na Web-to-C. W 1990 roku prace nad projektem +przejął Karl Berry wraz z dziesiątkami współpracowników, a w roku 1997 pałeczkę przejął Olaf +Weber. +<!--l. 2156--><p class="indent" > Web2C działa na platformach systemowych, takich jak Unix (w tym Mac OS X), Windows 9x/NT/2K/XP +i innych. System wykorzystuje oryginalne źródła <span class="TEX">T<span +class="E">E</span>X</span>-owe autorstwa Donalda Knutha oraz inne programy +napisane w <span +class="ec-lmtt-10">WEB </span>i tłumaczy je na kod źródłowy C. Ponadto system udostępnia spory zestaw makr i funkcji +stworzonych dla zwiększenia funkcjonalności oryginalnych zasobów oprogramowania związanego z <span class="TEX">T<span +class="E">E</span>X</span>-em. +Podstawowymi składnikami systemu są: +<!--l. 2164--><p class="indent" > + <dl class="list1"><dt class="list"> + <span +class="ec-lmss-10">bibtex</span> </dt><dd +class="list"> + <!--l. 2165--><p class="noindent" >tworzenie spisów bibliograficznych; + </dd><dt class="list"> + <span +class="ec-lmss-10">dvicopy</span> </dt><dd +class="list"> + <!--l. 2166--><p class="noindent" >modyfikowanie pliku DVI; + </dd><dt class="list"> + <span +class="ec-lmss-10">dvitomp</span> </dt><dd +class="list"> + <!--l. 2167--><p class="noindent" >konwersja DVI do MPX (rysunki MetaPost-owe); + </dd><dt class="list"> + <span +class="ec-lmss-10">dvitype</span> </dt><dd +class="list"> + <!--l. 2168--><p class="noindent" >konwersja DVI na plik tekstowy (ASCII); + </dd><dt class="list"> + <span +class="ec-lmss-10">gftodvi</span> </dt><dd +class="list"> + <!--l. 2169--><p class="noindent" >zamiana fontu GF na plik DVI; + + + </dd><dt class="list"> + <span +class="ec-lmss-10">gftopk</span> </dt><dd +class="list"> + <!--l. 2170--><p class="noindent" >zamiana fontu w formacie GF na font spakowany (PK); + </dd><dt class="list"> + <span +class="ec-lmss-10">gftype</span> </dt><dd +class="list"> + <!--l. 2171--><p class="noindent" >zamiana fontu GF na plik tekstowy (ASCII); + </dd><dt class="list"> + <span +class="ec-lmss-10">mf</span> </dt><dd +class="list"> + <!--l. 2172--><p class="noindent" >generowanie fontów bitmapowych w formacie GF; + </dd><dt class="list"> + <span +class="ec-lmss-10">mft</span> </dt><dd +class="list"> + <!--l. 2173--><p class="noindent" >skład plików źródłowych Metafont-a; + </dd><dt class="list"> + <span +class="ec-lmss-10">mpost</span> </dt><dd +class="list"> + <!--l. 2174--><p class="noindent" >tworzenie rysunków oraz diagramów technicznych; + </dd><dt class="list"> + <span +class="ec-lmss-10">patgen</span> </dt><dd +class="list"> + <!--l. 2175--><p class="noindent" >tworzenie wzorców przenoszenia wyrazów; + </dd><dt class="list"> + <span +class="ec-lmss-10">pktogf</span> </dt><dd +class="list"> + <!--l. 2176--><p class="noindent" >zamiana fontów w formacie PK na fonty GF; + </dd><dt class="list"> + <span +class="ec-lmss-10">pktype</span> </dt><dd +class="list"> + <!--l. 2177--><p class="noindent" >zamiana fontu PK na plik tekstowy (ASCII); + </dd><dt class="list"> + <span +class="ec-lmss-10">pltotf</span> </dt><dd +class="list"> + <!--l. 2178--><p class="noindent" >konwersja tekstowej listy właściwości do TFM; + </dd><dt class="list"> + <span +class="ec-lmss-10">pooltype</span> </dt><dd +class="list"> + <!--l. 2179--><p class="noindent" >wyświetlanie <span +class="ec-lmtt-10">WEB</span>-owych plików pool; + </dd><dt class="list"> + <span +class="ec-lmss-10">tangle</span> </dt><dd +class="list"> + <!--l. 2180--><p class="noindent" >konwersja <span +class="ec-lmtt-10">WEB </span>do języka Pascal; + </dd><dt class="list"> + <span +class="ec-lmss-10">tex</span> </dt><dd +class="list"> + <!--l. 2181--><p class="noindent" >skład tekstu; + </dd><dt class="list"> + <span +class="ec-lmss-10">tftopl</span> </dt><dd +class="list"> + <!--l. 2182--><p class="noindent" >konwersja TFM do tekstowej listy właściwości (PL); + </dd><dt class="list"> + <span +class="ec-lmss-10">vftovp</span> </dt><dd +class="list"> + <!--l. 2183--><p class="noindent" >konwersja fontów wirtualnych do wirtualnej listy właściwości (VPL); + </dd><dt class="list"> + <span +class="ec-lmss-10">vptovf</span> </dt><dd +class="list"> + <!--l. 2185--><p class="noindent" >konwersja wirtualnej listy właściwości do fontów wirtualnych; + </dd><dt class="list"> + <span +class="ec-lmss-10">weave</span> </dt><dd +class="list"> + <!--l. 2186--><p class="noindent" >konwersja <span +class="ec-lmtt-10">WEB </span>do <span class="TEX">T<span +class="E">E</span>X</span>-a.</dd></dl> + + +<!--l. 2189--><p class="noindent" >Dokładny opis funkcji oraz składni tych programów zawarty jest w dokumentacji poszczególnych pakietów +samego Web2C. Do optymalnego korzystania z instalacji Web2C przyda się znajomość kilku zasad rządzących +całą rodziną programów. +<!--l. 2195--><p class="indent" > Wszystkie programy obsługują standardowe opcje GNU: + <dl class="description"><dt class="description"> +<span +class="ec-lmtk-10">--help</span><span +class="ec-lmtk-10"> </span><span +class="ec-lmtk-10"> </span><span +class="ec-lmtk-10"> </span> </dt><dd +class="description">podaje podstawowe zasady użytkowania; + </dd><dt class="description"> +<span +class="ec-lmtk-10">--verbose</span> </dt><dd +class="description">podaje dokładny raport z działania programu; + </dd><dt class="description"> +<span +class="ec-lmtk-10">--version</span> </dt><dd +class="description">podaje informację o wersji, po czym kończy działanie programu.</dd></dl> +<!--l. 2203--><p class="indent" > Do lokalizowania plików programy oparte na Web2C używają biblioteki do przeszukiwania ścieżek zwanej +Kpathsea. Dla optymalizacji przeszukiwania <span class="TEX">T<span +class="E">E</span>X</span>-owego drzewa podkatalogów biblioteka ta używa +kombinacji zmiennych środowiskowych oraz kilku plików konfiguracyjnych. Web2C potrafi obsługiwać +jednocześnie więcej niż jedno drzewo podkatalogów, co jest użyteczne w wypadku, gdy chce się +przechowywać standardową dystrybucję <span class="TEX">T<span +class="E">E</span>X</span>-a jak i lokalne rozszerzenia w dwóch różnych drzewach +katalogów. Aby przyspieszyć poszukiwanie plików, katalog główny każdego drzewa ma swój plik <span +class="ec-lmtt-10">ls-R</span>, +zawierający pozycje określające nazwę i względną ścieżkę dla wszystkich plików zawartych w tym +katalogu. +<!--l. 2215--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">8.1. </span> <a + id="x1-580008.1"></a>Przeszukiwanie ścieżek przez Kpathsea</h4> +<!--l. 2218--><p class="noindent" >Opiszemy najpierw ogólny mechanizm przeszukiwania ścieżek przez bibliotekę Kpathsea. +<!--l. 2221--><p class="indent" > Tym, co nazywamy <span +class="ec-lmri-10">ście</span><span +class="ec-lmri-10">żką przeszukiwania</span>, jest rozdzielona dwukropkami lub średnikami lista <span +class="ec-lmri-10">element</span><span +class="ec-lmri-10">ów</span> +<span +class="ec-lmri-10">ście</span><span +class="ec-lmri-10">żki</span>, które zasadniczo są nazwami podkatalogów. Ścieżka przeszukiwania może pochodzić z (kombinacji) +wielu źródeł. Przykładowo, aby odnaleźć plik „<span +class="ec-lmtt-10">my-file</span>” w ścieżce „<span +class="ec-lmtt-10">.:/dir</span>”, Kpathsea sprawdza istnienie +danego elementu ścieżki w następującej kolejności: najpierw <span +class="ec-lmtt-10">./my-file</span>, potem <span +class="ec-lmtt-10">/dir/my-file</span>, zwracając +pierwszy odnaleziony (lub możliwie wszystkie). +<!--l. 2229--><p class="indent" > Aby optymalnie zaadaptować się do konwencji wszystkich systemów operacyjnych, na systemach +nieunixowych Kpathsea może używać jako separatorów nazw ścieżek znaków innych niż dwukropek („<span +class="ec-lmtt-10">:</span>”) oraz +„ciach” („<span +class="ec-lmtt-10">/</span>”). +<!--l. 2234--><p class="indent" > W celu sprawdzenia konkretnego elementu <span +class="ec-lmro-10">p </span>ścieżki, Kpathsea najpierw sprawdza, czy zbudowana +wcześniej baza danych (patrz „Baza nazw plików” na str. <a +href="#x1-660008.2">70<!--tex4ht:ref: Filename-database --></a>) odnosi sie do <span +class="ec-lmro-10">p</span>, tj. czy baza danych znajduje się +w podkatalogu z prefiksem <span +class="ec-lmro-10">p</span>. Jeżeli tak, to specyfikacja ścieżki jest porównywana z zawartością +bazy. +<!--l. 2240--><p class="indent" > Jeśli baza danych nie istnieje bądź nie odnosi się do danego elementu ścieżki albo też nie zawiera +elementów zgodnych, to przeszukiwany jest system plików (jeżeli nie zostało to zabronione przez specyfikację +rozpoczynającą się od „<span +class="ec-lmtt-10">!!</span>” oraz jeżeli poszukiwany plik musi istnieć). Kpathsea konstruuje listę +podkatalogów, które korespondują z danym elementem ścieżki, a następnie sprawdza w każdym z nich, czy +nie ma tam poszukiwanego pliku. +<!--l. 2248--><p class="indent" > Warunek mówiący, że „plik musi istnieć” dotyczy np. plików „<span +class="ec-lmtt-10">.vf</span>” i plików dołączanych <span class="TEX">T<span +class="E">E</span>X</span>-owym +poleceniem <span +class="ec-lmtt-10">\openin</span>. Takiego pliku może nie być (np. <span +class="ec-lmtt-10">cmr10.vf</span>), błędne byłoby zatem poszukiwanie go na +dysku. Jeśli więc zapomnisz o aktualizacji <span +class="ec-lmtt-10">ls-R </span>po instalacji nowego pliku „<span +class="ec-lmtt-10">.vf</span>”, to nie zostanie on +odnaleziony. Każdy element ścieżki sprawdzany jest w następującej kolejności: najpierw w bazie danych, +potem na dysku. Jeżeli plik się znajdzie, to przeszukiwanie zostanie zatrzymane i zwrócony zostanie +wynik. +<!--l. 2259--><p class="indent" > Ponieważ najprostszym i najbardziej powszechnym elementem ścieżki jest nazwa katalogu, Kpathsea +korzysta z dodatkowych możliwości w przeszukiwaniu ścieżek: wielowarstwowych wartości domyślnych, +zmiennych środowiskowych, wartości pliku konfiguracyjnego, lokalnych podkatalogów użytkownika oraz +rekursywnego przeszukiwania podkatalogów. Można więc powiedzieć, że Kpathsea <span +class="ec-lmri-10">rozwija </span>element ścieżki, +tzn. transformuje wszystkie specyfikacje do podstawowej nazwy lub nazw katalogów. Jest to opisane +w kolejnych akapitach, w kolejności w jakiej to zachodzi. +<!--l. 2269--><p class="indent" > Trzeba zauważyć, że jeżeli nazwa poszukiwanego pliku jest absolutna lub jawnie względna, tj. +zaczyna się od „<span +class="ec-lmtt-10">/</span>” lub „<span +class="ec-lmtt-10">./</span>” lub „<span +class="ec-lmtt-10">../</span>”, to Kpathsea ogranicza się do sprawdzenia, czy ten plik +istnieje. + + +<!--l. 2283--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.1.1. </span> <a + id="x1-590008.1.1"></a>Źródła ścieżek</h5> +<!--l. 2286--><p class="noindent" >Nazwa przeszukiwanej ścieżki może pochodzić z wielu źródeł. Oto kolejność, w jakiej Kpathsea ich +używa: +<!--l. 2289--><p class="indent" > + <ol class="enumerate1" > + <li + class="enumerate" id="x1-59002x1">Zmienna środowiskowa ustawiana przez użytkownika, np. <span +class="ec-lmtt-10">TEXINPUTS</span>. + Zmienne środowiskowe z dołączoną kropką i nazwą programu zastępują inne, np. jeżeli „<span +class="ec-lmtt-10">latex</span>” + jest nazwą uruchomionego programu, wtedy zamiast <span +class="ec-lmtt-10">TEXINPUTS </span>wykorzystana zostanie zmienna + <span +class="ec-lmtt-10">TEXINPUTS.latex</span>. + </li> + <li + class="enumerate" id="x1-59004x2">Plik konfiguracyjny konkretnego programu, np. linia „<span +class="ec-lmtt-10">S /a:/b</span>” w pliku <span +class="ec-lmtt-10">config.ps </span>programu + <span +class="ec-lmss-10">dvips</span>. + </li> + <li + class="enumerate" id="x1-59006x3">Plik konfiguracyjny Kpathsea <span +class="ec-lmtt-10">texmf.cnf</span>, zawierający taką linię, jak „<span +class="ec-lmtt-10">TEXINPUTS=/c:/d</span>” (patrz + poniżej). + </li> + <li + class="enumerate" id="x1-59008x4">Wartości domyślne dla uruchamianych programów.</li></ol> +<!--l. 2303--><p class="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 str. <a +href="#x1-700008.2.4">73<!--tex4ht:ref: sec:debugging --></a>). +<!--l. 2307--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.1.2. </span> <a + id="x1-600008.1.2"></a>Pliki konfiguracyjne</h5> +<!--l. 2310--><p class="noindent" >Kpathsea szuka ścieżek przeszukiwania i innych definicji w <span +class="ec-lmri-10">plikach konfiguracyjnych </span>o nazwach <span +class="ec-lmtt-10">texmf.cnf</span>. +Ścieżka przeszukiwania używana do znajdowania tych plików określana jest przez zmienną <span +class="ec-lmtt-10">TEXMFCNF</span>, ale nie +zalecamy jawnego ustawiania tej, jak i innych zmiennych w systemie. Zamiast tego typowa instalacja <span class="TEX">T<span +class="E">E</span>X</span> +Live tworzy plik <span +class="ec-lmtt-10">.../2012/texmf.cnf</span>, który w wyjątkowych wypadkach możemy modyfikować. Głównym +plikiem konfiguracyjnym jest <span +class="ec-lmtt-10">.../2012/texmf/web2c/texmf.cnf</span>, ale nie powinien być on modyfikowany, +gdyż zmiany będą utracone podczas aktualizacji. +<!--l. 2324--><p class="indent" > Czytane będą <span +class="ec-lmri-10">wszystkie </span>pliki <span +class="ec-lmtt-10">texmf.cnf </span>w ścieżce przeszukiwania, a definicje we wcześniejszych plikach +zastąpią te w późniejszych. Tak więc w ścieżce <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">.:$TEXMF</span></span></span> wartości pochodzące z <span +class="ec-lmtt-10">./texmf.cnf </span>zastąpią te +z <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">$TEXMF/texmf.cnf</span></span></span>. +<!--l. 2331--><p class="indent" > Dociekliwy czytelnik może być zainteresowany sposobem, w jaki programy znajdują plik <span +class="ec-lmtt-10">texmf.cnf</span>, skoro +nie ma konieczności deklarowania specyficznej zmiennej środowiskowej systemu. Otóż położenie domyślne jest +wkompilowane w programy jako względne do ich położenia (określanego, jak wiemy, w ścieżce specyfikowanej +przez <span +class="ec-lmtt-10">$PATH</span>): <span class="path"><span +class="ec-lmtt-10">../../texmf/web2c/</span></span> bądź <span class="path"><span +class="ec-lmtt-10">../texmf/web2c/</span></span>. Jeśli jawnie deklarujemy zmienną <span +class="ec-lmtt-10">TEXMFCNF</span>, +wymagane jest podanie bezwzględnej ścieżki. +<!--l. 2340--><p class="indent" > Czytając zamieszczony poniżej opis formatu pliku <span +class="ec-lmtt-10">texmf.cnf</span>, warto przeglądać jego zawartość. Położenie +<span +class="ec-lmri-10">aktywnego </span>pliku znajdziemy za pomocą polecenia <span +class="ec-lmtt-10">kpsewhich texmf.cnf</span>. + <ul class="itemize1"> + <li class="itemize">Komentarze zaczynają się od „<span +class="ec-lmtt-10">%</span>”, a kończą na końcu wiersza. + </li> + <li class="itemize">Puste wiersze nie są brane pod uwagę. + </li> + <li class="itemize">Znak „<span +class="ec-lmtt-10">\</span>” na końcu wiersza działa jako znak kontynuacji, tzn. oznacza, że kolejny wiersz jest + kontynuacją bieżącego. Spacja na początku kolejnego wiersza nie jest ignorowana. + </li> + <li class="itemize">Pozostałe wiersze mają postać: <div class="alltt"> + <!--l. 2355--><p class="noindent" ><div class="obeylines-v"> + <span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtti-10">zmienna</span><span +class="ec-lmtt-10">[.</span><span +class="ec-lmtti-10">program</span><span +class="ec-lmtt-10">]</span><span +class="ec-lmtt-10"> [=]</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtti-10">warto</span><span +class="ec-lmtti-10">ś</span><span +class="ec-lmtti-10">ć</span> + + +</div> + </div>gdzie „<span +class="ec-lmtt-10">=</span>” i otaczające spacje są opcjonalne. + </li> + <li class="itemize">„<span +class="ec-lmro-10">zmienna</span>” zawierać może dowolne znaki poza spacją, „<span +class="ec-lmtt-10">=</span>”, lub „<span +class="ec-lmtt-10">.</span>” (kropką), najbezpieczniej jednak + używać znaków z zakresu „<span +class="ec-lmtt-10">A-Za-z_</span>”. + </li> + <li class="itemize">Napis „<span +class="ec-lmtt-10">.</span><span +class="ec-lmro-10">program</span>” ma zastosowanie w wypadku, gdy uruchamiany program nosi nazwę + <span +class="ec-lmro-10">program </span>lub <span +class="ec-lmro-10">program</span><span +class="ec-lmtt-10">.exe</span>. Pozwala to różnym odmianom <span class="TEX">T<span +class="E">E</span>X</span>-a stosować różne ścieżki + przeszukiwania. + </li> + <li class="itemize">„<span +class="ec-lmro-10">warto</span><span +class="ec-lmro-10">ś</span><span +class="ec-lmro-10">ć</span>” zawierać może dowolne znaki poza „<span +class="ec-lmtt-10">%</span>” i „<span +class="ec-lmtt-10">@</span>”. Nie można używać konstrukcji + „<span +class="ec-lmtt-10">$</span><span +class="ec-lmro-10">zmienna</span><span +class="ec-lmtt-10">.</span><span +class="ec-lmro-10">program</span>” po prawej stronie. Zamiast tego trzeba zastosować zmienną pomocniczą. + Jeżeli systemem operacyjnym jest Unix, to średnik „<span +class="ec-lmtt-10">;</span>” użyty w „<span +class="ec-lmro-10">warto</span><span +class="ec-lmro-10">ś</span><span +class="ec-lmro-10">ć</span>” zamieniany + jest na „<span +class="ec-lmtt-10">:</span>”; umożliwia to istnienie wspólnego pliku <span +class="ec-lmtt-10">texmf.cnf </span>dla systemów Unix oraz + Windows. + </li> + <li class="itemize">Wszystkie definicje czytane są zanim cokolwiek zostanie rozwinięte, tak więc do zmiennych można się + odwoływać przed ich zdefiniowaniem.</li></ul> +<!--l. 2380--><p class="noindent" >Oto fragment pliku konfiguracyjnego ilustrujący większość opisanych powyżej reguł notacji: + <div class="fancyvrb" id="fancyvrb18"> +<a + id="x1-60002r1"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> TEXMF</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> =</span><span +class="ec-lmtt-8x-x-87"> {$TEXMFLOCAL,!!$TEXMFMAIN}</span> +<br class="fancyvrb" /><a + id="x1-60004r2"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> TEXINPUTS.latex</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> =</span><span +class="ec-lmtt-8x-x-87"> .;$TEXMF/tex/{latex,generic;}//</span> +<br class="fancyvrb" /><a + id="x1-60006r3"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> TEXINPUTS.fontinst</span><span +class="ec-lmtt-8x-x-87"> =</span><span +class="ec-lmtt-8x-x-87"> .;$TEXMF/tex//;$TEXMF/fonts/afm//</span> +<br class="fancyvrb" /><a + id="x1-60008r4"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> %</span><span +class="ec-lmtt-8x-x-87"> e-TeX</span><span +class="ec-lmtt-8x-x-87"> related</span><span +class="ec-lmtt-8x-x-87"> files</span> +<br class="fancyvrb" /><a + id="x1-60010r5"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> TEXINPUTS.elatex</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> =</span><span +class="ec-lmtt-8x-x-87"> .;$TEXMF/{etex,tex}/{latex,generic;}//</span> +<br class="fancyvrb" /><a + id="x1-60012r6"></a><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> TEXINPUTS.etex</span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> </span><span +class="ec-lmtt-8x-x-87"> =</span><span +class="ec-lmtt-8x-x-87"> .;$TEXMF/{etex,tex}/{eplain,plain,generic;}//</span> + </div> +<!--l. 2388--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.1.3. </span> <a + id="x1-610008.1.3"></a>Rozwijanie ścieżek</h5> +<!--l. 2391--><p class="noindent" >Kpathsea rozpoznaje w ścieżkach przeszukiwania pewne specjalne znaki oraz konstrukcje, podobne do tych, +które są dostępne w powłokach systemów typu Unix. Jako ogólny przykład: złożona ścieżka +<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">~$USER/{foo,bar}//baz</span></span></span> rozwija się do wszystkich podkatalogów pod katalogami <span +class="ec-lmtt-10">foo </span>i <span +class="ec-lmtt-10">bar </span>w katalogu +głównym <span +class="ec-lmtt-10">$USER</span>, które zawierają katalog lub plik <span +class="ec-lmtt-10">baz</span>. Rozwinięcia te opisane są w poniższych +podrozdziałach. +<!--l. 2400--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.1.4. </span> <a + id="x1-620008.1.4"></a>Rozwijanie domyślne</h5> +<!--l. 2404--><p class="noindent" >Jeżeli ścieżka przeszukiwania największego uprzywilejowania (patrz „Źródła ścieżek” na str. <a +href="#x1-590008.1.1">65<!--tex4ht:ref: Path-sources --></a>) zawiera +<span +class="ec-lmri-10">dodatkowy dwukropek </span>(np. na początku, na końcu lub podwójny), to Kpathsea wstawia w tym miejscu +następną zdefiniowaną w hierarchii uprzywilejowania ścieżkę przeszukiwania. Jeżeli ta wstawiona +ścieżka ma dodatkowy dwukropek, to dzieje się dalej to samo. Przykładowo, jeżeli ustawić zmienną +środowiskową + <div class="alltt"> +<!--l. 2413--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">setenv</span><span +class="ec-lmtk-10"> TEXINPUTS</span><span +class="ec-lmtk-10"> /home/karl:</span> +</div> +</div> oraz wartość <span +class="ec-lmtt-10">TEXINPUTS </span>pobraną z <span +class="ec-lmtt-10">texmf.cnf</span> + <div class="alltt"> +<!--l. 2418--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> .:$TEXMF//tex</span> + + +</div> +</div> to końcową wartością użytą w przeszukiwaniu będzie: + <div class="alltt"> +<!--l. 2423--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /home/karl:.:$TEXMF//tex</span> +</div> +</div> +<!--l. 2427--><p class="indent" > Ponieważ nieużytecznym byłoby wstawiać wartość domyślną w więcej niż jednym miejscu, Kpathsea +zmienia tylko jeden dodatkowy „<span +class="ec-lmtt-10">:</span>” i pozostawia inne bez zmian. Kpathsea najpierw szuka dwukropków na +początku linii, potem na końcu, a następnie podwójnych. +<!--l. 2432--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.1.5. </span> <a + id="x1-630008.1.5"></a>Rozwijanie nawiasów</h5> +<!--l. 2435--><p class="noindent" >Użyteczna jest możliwość rozwijania nawiasów, co oznacza, że np. <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">v{a,b}w</span></span></span> rozwija się do <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">vaw:vbw</span></span></span>. Nawiasy +można też zagnieżdżać. Funkcji tej można użyć do zaimplementowania różnych hierarchii <span class="TEX">T<span +class="E">E</span>X</span>-owych przez +przypisanie listy nawiasów do <span +class="ec-lmtt-10">$TEXMF</span>. Przykładowo, w pliku <span +class="ec-lmtt-10">texmf.cnf </span>można znaleźć następującą +(uproszczoną tu) definicję: + + + <div class="verbatim" id="verbatim-6"> + <div class="fancyvrb" id="fancyvrb19"><a + id="x1-63002r1"></a>    TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN}</div> +</div> +<!--l. 2444--><p class="nopar" >Używając jej, można następnie napisać coś w rodzaju: + + + <div class="verbatim" id="verbatim-7"> + <div class="fancyvrb" id="fancyvrb20"><a + id="x1-63004r1"></a>    TEXINPUTS = .;$TEXMF/tex//</div> +</div> +<!--l. 2448--><p class="nopar" >co oznacza, że po szukaniu w katalogu bieżącym będą przeszukane kolejno <span +class="ec-lmtt-10">$TEXMFHOME/tex</span>, +<span +class="ec-lmtt-10">$TEXMFLOCAL/tex</span>, <span +class="ec-lmtt-10">$TEXMFVAR/tex </span>i <span +class="ec-lmtt-10">$TEXMFMAIN/tex </span>(wszystkie wraz z katalogami niższego poziomu; dwie +ostatnie ścieżki <span +class="ec-lmri-10">wyłącznie </span>na podstawie zawartości pliku <span +class="ec-lmtt-10">ls-R</span>). Jest to wygodny sposób na uruchamianie +dwóch równoległych struktur <span class="TEX">T<span +class="E">E</span>X</span>-owych, jednej „zamrożonej” (np. na CD), a drugiej ciągle uaktualnianej +nowo pojawiającymi się wersjami. Używając zmiennej <span +class="ec-lmtt-10">$TEXMF </span>we wszystkich definicjach daje pewność, że +najpierw przeszukiwane jest drzewo uaktualnione. +<!--l. 2460--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.1.6. </span> <a + id="x1-640008.1.6"></a>Rozwijanie podkatalogów</h5> +<!--l. 2463--><p class="noindent" >Dwa lub więcej kolejnych „ciachów” („/”) w elemencie ścieżki, występujących po nazwie katalogu <span +class="ec-lmro-10">d</span>, +zastępowanych jest przez wszystkie podkatalogi <span +class="ec-lmro-10">d</span>, najpierw podkatalogi znajdujące się bezpośrednio pod <span +class="ec-lmro-10">d</span>, +potem te pod powyższymi i tak dalej. Na każdym etapie kolejność, w jakiej przeszukiwane są katalogi, jest +<span +class="ec-lmri-10">nieokre</span><span +class="ec-lmri-10">ślona</span>. +<!--l. 2469--><p class="indent" > Jeśli wyszczególni się człony nazwy pliku po „<span +class="ec-lmtt-10">//</span>”, to uwzględnione zostaną tylko te podkatalogi, które +zawierają powyższe człony. Na przykład „<span +class="ec-lmtt-10">/a//b</span>” rozwija się do katalogów <span +class="ec-lmtt-10">/a/1/b</span>, <span +class="ec-lmtt-10">/a/2/b</span>, <span +class="ec-lmtt-10">/a/1/1/b </span>itd., ale +nie do <span +class="ec-lmtt-10">/a/b/c </span>czy <span +class="ec-lmtt-10">/a/1</span>. +<!--l. 2474--><p class="indent" > Możliwe jest wielokrotne użycie „<span +class="ec-lmtt-10">//</span>” w ścieżce, jednakże „<span +class="ec-lmtt-10">//</span>” występujące na początku ścieżki nie jest +brane pod uwagę. +<!--l. 2477--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.1.7. </span> <a + id="x1-650008.1.7"></a>Lista znaków specjalnych i ich znaczeń – podsumowanie</h5> +<!--l. 2479--><p class="noindent" >Poniższa lista podsumowuje znaczenie znaków specjalnych w plikach konfiguracyjnych. +<!--l. 2483--><p class="indent" > + <dl class="description"><dt class="description"> +<span +class="ec-lmtk-10">:</span> </dt><dd +class="description">znak rozdzielający w specyfikacji ścieżki; umieszczony na początku lub na końcu ścieżki + zastępuje domyślne rozwinięcie ścieżki; + </dd><dt class="description"> +<span +class="ec-lmtk-10">;</span> </dt><dd +class="description">znak rozdzielający dla systemów nieuniksowych (działa tak jak „<span +class="ec-lmtt-10">:</span>”); + </dd><dt class="description"> +<span +class="ec-lmtk-10">$</span> </dt><dd +class="description">rozwijanie zmiennej; + </dd><dt class="description"> +<span +class="ec-lmtk-10">~</span> </dt><dd +class="description">oznacza katalog główny użytkownika; + </dd><dt class="description"> +<span +class="ec-lmtk-10">{</span><span +class="ec-lmtk-10">…}</span> </dt><dd +class="description">rozwijanie nawiasów, np. <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">a{1,2}b</span></span></span> zmieni się w <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">a1b:a2b</span></span></span>; + </dd><dt class="description"> +<span +class="ec-lmtk-10">//</span> </dt><dd +class="description">rozwijanie podkatalogów (może wystąpić gdziekolwiek w ścieżce, poza jej początkiem); + </dd><dt class="description"> +<span +class="ec-lmtk-10">%</span> </dt><dd +class="description">początek komentarza, obejmującego wszystkie znaki do końca linii; + </dd><dt class="description"> +<span +class="ec-lmtt-10">\</span> </dt><dd +class="description">znak kontynuacji (pozwala na przełamanie wiersza z wyrażeniem); + </dd><dt class="description"> +<span +class="ec-lmtk-10">!!</span> </dt><dd +class="description">przeszukiwanie <span +class="ec-lmri-10">tylko </span>bazy danych, a <span +class="ec-lmri-10">nie </span>dysku.</dd></dl> + + +<!--l. 2503--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">8.2. </span> <a + id="x1-660008.2"></a>Bazy nazw plików</h4> +<!--l. 2506--><p class="noindent" >Podczas przeszukiwania Kpathsea stara się zminimalizować dostęp do dysku. Niemniej, w przypadku instalacji +ze zbyt dużą liczbą katalogów przeglądanie każdego dopuszczalnego katalogu w poszukiwaniu pliku może +zabierać sporo czasu (ma to miejsce zwłaszcza, jeżeli przeszukać trzeba setki katalogów z fontami). +Dlatego też Kpathsea może używać zewnętrznego pliku z „bazą danych” o nazwie <span +class="ec-lmtt-10">ls-R</span>, który +zawiera przypisania plików do katalogów. Unika się w ten sposób czasochłonnego przeszukiwania +dysku. +<!--l. 2515--><p class="indent" > Drugi plik z bazą danych – <span +class="ec-lmtt-10">aliases </span>– pozwala na nadawanie dodatkowych nazw plikom zawartym w <span +class="ec-lmtt-10">ls-R</span>. +Może to być pomocne do adaptacji do DOS-owej konwencji „8.3” nazewnictwa plików w plikach +źródłowych. +<!--l. 2520--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.2.1. </span> <a + id="x1-670008.2.1"></a>Baza nazw plików</h5> +<!--l. 2523--><p class="noindent" >Jak wspomniano, plik zawierający główną bazę nazw plików musi nosić nazwę <span +class="ec-lmtt-10">ls-R</span>. W katalogu +podstawowym każdej hierarchii <span class="TEX">T<span +class="E">E</span>X</span>-owej (domyślnie <span +class="ec-lmtt-10">$TEXMF</span>), którą chcemy włączyć w mechanizm +przeszukiwania, umieszczać można po jednym pliku <span +class="ec-lmtt-10">ls-R</span>; w większości przypadków istnieje tylko jedna +hierarchia. Kpathsea szuka pliku <span +class="ec-lmtt-10">ls-R </span>w ścieżce <span +class="ec-lmtt-10">TEXMFDBS</span>. +<!--l. 2530--><p class="indent" > Najlepszym sposobem stworzenia i utrzymywania pliku <span +class="ec-lmtt-10">ls-R </span>jest uruchomienie skryptu <span +class="ec-lmtt-10">mktexlsr</span>, +będącego składnikiem dystrybucji. Jest on wywoływany przez różne skrypty typu „<span +class="ec-lmtt-10">mktex...</span>”. W zasadzie +skrypt ten jedynie wykonuje polecenie <div class="alltt"> +<!--l. 2534--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">cd</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmro-10">/your/texmf/root</span><span +class="ec-lmtt-10"> &&</span><span +class="ec-lmtt-10"> ls</span><span +class="ec-lmtt-10"> -LAR</span><span +class="ec-lmtt-10"> ./</span><span +class="ec-lmtt-10"> >ls-R</span> +</div> +</div> zakładając, że polecenie <span +class="ec-lmtt-10">ls </span>danego systemu utworzy właściwy format strumienia wyjściowego (GNU <span +class="ec-lmtt-10">ls</span> +działa prawidłowo). Aby mieć pewność, że baza danych jest zawsze aktualna, wygodnie jest przebudowywać +ją regularnie za pomocą demona <span +class="ec-lmtt-10">cron</span>. +<!--l. 2545--><p class="indent" > Jeśli pliku nie ma w bazie danych, Kpathsea domyślnie przechodzi do przeszukiwania dysku. Jeżeli jednak +dany element ścieżki zaczyna sie od „<span +class="ec-lmtt-10">!!</span>”, to w poszukiwaniu tego elementu sprawdzona zostanie <span +class="ec-lmri-10">jedynie </span>baza +danych, a nigdy dysk. +<!--l. 2550--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.2.2. </span> <a + id="x1-680008.2.2"></a>kpsewhich – program do przeszukiwania ścieżek</h5> +<!--l. 2553--><p class="noindent" >Przeszukiwanie ścieżek przez program <span +class="ec-lmtt-10">kpsewhich </span>jest niezależne od jakiejkolwiek aplikacji. Może on być +przydatny jako rodzaj programu <span +class="ec-lmtt-10">find</span>, za pomocą którego lokalizować można pliki w hierarchiach <span class="TEX">T<span +class="E">E</span>X</span>-owych +(jest on używany intensywnie w skryptach „<span +class="ec-lmtt-10">mktex...</span>” tej dystrybucji). + <div class="alltt"> +<!--l. 2559--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> </span><span +class="ec-lmro-10">opcje</span><span +class="ec-lmtk-10">…</span><span +class="ec-lmtk-10"> </span><span +class="ec-lmro-10">nazwa-pliku</span><span +class="ec-lmtk-10">…</span> +</div> +</div> Parametry wyszczególnione w „<span +class="ec-lmro-10">opcje</span>” mogą zaczynać się zarówno od „<span +class="ec-lmtt-10">-</span>”, jak i od „<span +class="ec-lmtt-10">--</span>”, a dozwolony jest +każdy jednoznaczny skrót. +<!--l. 2565--><p class="indent" > Kpathsea traktuje każdy argument niebędący parametrem jako nazwę pliku i zwraca pierwszą odnalezioną +nazwę. Nie ma parametru nakazującego zwracanie wszystkich nazw plików o określonej nazwie (w tym celu +można wykorzystać Unix-owy program „<span +class="ec-lmtt-10">find</span>”). +<!--l. 2570--><p class="indent" > Oto ważniejsze parametry. +<!--l. 2572--><p class="noindent" > + <dl class="list1"><dt class="list"> + <span +class="ec-lmtt-10">--dpi=</span><span +class="ec-lmro-10">num</span> </dt><dd +class="list"> + <!--l. 2573--><p class="noindent" ><br +class="newline" />Ustaw rozdzielczość na „<span +class="ec-lmro-10">num</span>”; ma to tylko wpływ na przeszukiwanie fontów „<span +class="ec-lmtt-10">gf</span>” i „<span +class="ec-lmtt-10">pk</span>”. Dla + zgodności z <span +class="ec-lmss-10">dvips </span>parametr „<span +class="ec-lmtt-10">-D</span>” działa identycznie. Domyślną wartością jest 600. + + + </dd><dt class="list"> + <span +class="ec-lmtt-10">--format=</span><span +class="ec-lmro-10">nazwa</span> </dt><dd +class="list"> + <!--l. 2578--><p class="noindent" ><br +class="newline" />Ustawienie formatu (typu pliku) przeszukiwania na „<span +class="ec-lmro-10">nazwa</span>”. Domyślnie format odgadywany jest + z nazwy pliku. Dla formatów, które nie mają przydzielonego jednoznacznego rozszerzenia, takich + jak niektóre pliki MetaPost-owe czy pliki konfiguracyjne <span +class="ec-lmss-10">dvips</span>-a, należy wyszczególnić nazwę, + których listę wyświetli uruchomienie <span +class="ec-lmtt-10">kpsewhich --help</span>. + </dd><dt class="list"> + <span +class="ec-lmtt-10">--mode=</span><span +class="ec-lmro-10">napis</span> </dt><dd +class="list"> + <!--l. 2586--><p class="noindent" ><br +class="newline" />Ustaw nazwę trybu na „<span +class="ec-lmro-10">napis</span>”; dotyczy to jedynie szukania fontów „<span +class="ec-lmtt-10">gf</span>” oraz „<span +class="ec-lmtt-10">pk</span>”. Brakuje + wartości domyślnej – odnaleziony zostanie dowolny wyszczególniony tryb. + </dd><dt class="list"> + <span +class="ec-lmtt-10">--must-exist</span> </dt><dd +class="list"> + <!--l. 2591--><p class="noindent" ><br +class="newline" />Zrób wszystko co możliwe, aby odnaleźć pliki, włączając w to przede wszystkim przeszukanie + dysku. Domyślnie, w celu zwiększeniu efektywności działania, sprawdzana jest tylko baza <span +class="ec-lmtt-10">ls-R</span>. + </dd><dt class="list"> + <span +class="ec-lmtt-10">--path=</span><span +class="ec-lmro-10">napis</span> </dt><dd +class="list"> + <!--l. 2596--><p class="noindent" ><br +class="newline" />Szukaj w ścieżce „<span +class="ec-lmro-10">napis</span>” (rozdzielonej, jak zwykle, dwukropkami), zamiast zgadywać ścieżkę + przeszukiwania z nazwy pliku. „<span +class="ec-lmtt-10">//</span>” i wszystkie zwykłe rozszerzenia są możliwe. Parametry + „<span +class="ec-lmtt-10">--path</span>” oraz „<span +class="ec-lmtt-10">--format</span>” wzajemnie się wykluczają. + </dd><dt class="list"> + <span +class="ec-lmtt-10">--progname=</span><span +class="ec-lmro-10">nazwa</span> </dt><dd +class="list"> + <!--l. 2602--><p class="noindent" ><br +class="newline" />Ustaw nazwę programu na „<span +class="ec-lmro-10">nazwa</span>”. Może to mieć wpływ na ścieżkę przeszukiwania poprzez + „<span +class="ec-lmtt-10">.</span><span +class="ec-lmro-10">program</span>” w plikach konfiguracyjnych. Ustawieniem domyślnym jest „<span +class="ec-lmtt-10">kpsewhich</span>”. + </dd><dt class="list"> + <span +class="ec-lmtt-10">--show-path=</span><span +class="ec-lmro-10">nazwa</span> </dt><dd +class="list"> + <!--l. 2607--><p class="noindent" ><br +class="newline" />Pokazuje ścieżkę używaną do poszukiwania plików typu „<span +class="ec-lmro-10">nazwa</span>”. Użyć można zarówno + rozszerzenia („<span +class="ec-lmtt-10">.pk</span>”, „<span +class="ec-lmtt-10">.vf</span>”, etc.), jak i nazwy pliku, tak jak w wypadku parametru „<span +class="ec-lmtt-10">--format</span>”. + </dd><dt class="list"> + <span +class="ec-lmtt-10">--debug=</span><span +class="ec-lmro-10">num</span> </dt><dd +class="list"> + <!--l. 2612--><p class="noindent" ><br +class="newline" />ustawia parametry wykrywania błędów na „<span +class="ec-lmro-10">num</span>”.</dd></dl> +<!--l. 2621--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.2.3. </span> <a + id="x1-690008.2.3"></a>Przykłady użycia</h5> +<!--l. 2624--><p class="noindent" >Przyjrzyjmy sie teraz, jak działa Kpathsea. + <div class="alltt"> +<!--l. 2626--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> </span><span +class="ec-lmtk-10"> article.cls</span> +<br /><span +class="ec-lmtt-10">/usr/local/texmf-dist/tex/latex/base/article.cls</span> +</div> +</div> Szukamy tu pliku <span +class="ec-lmtt-10">article.cls</span>. Ponieważ rozszerzenie „<span +class="ec-lmtt-10">.cls</span>” jest jednoznaczne, nie musimy zaznaczać, że +poszukujemy pliku typu „tex” (katalogi plików źródłowych <span class="TEX">T<span +class="E">E</span>X</span>-a). Znajdujemy go w podkatalogu +<span +class="ec-lmtt-10">tex/latex/base</span>, pod katalogiem nadrzędnym „<span +class="ec-lmtt-10">texmf-dist</span>”. Podobnie wszystkie poniższe pliki odnajdywane +są bezproblemowo dzięki swoim jednoznacznym rozszerzeniom: <div class="alltt"> + + +<!--l. 2637--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> array.sty</span> +<br /><span +class="ec-lmtt-10">/usr/local/texmf-dist/tex/latex/tools/array.sty</span> +<br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> latin1.def</span> +<br /><span +class="ec-lmtt-10">/usr/local/texmf-dist/tex/latex/base/latin1.def</span> +<br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> size10.clo</span> +<br /><span +class="ec-lmtt-10">/usr/local/texmf-dist/tex/latex/base/size10.clo</span> +<br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> small2e.tex</span> +<br /><span +class="ec-lmtt-10">/usr/local/texmf-dist/tex/latex/base/small2e.tex</span> +<br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> tugboat.bib</span> +<br /><span +class="ec-lmtt-10">/usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib</span> +</div> +</div> +<!--l. 2650--><p class="noindent" >(ostatni plik to BibTeX-owa baza bibliograficzna dla artykułów <span +class="ec-lmri-10">TUGBoat</span>). + <div class="alltt"> +<!--l. 2653--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> cmr10.pk</span> +</div> +</div> Pliki czcionek bitmapowych typu <span +class="ec-lmtt-10">.pk </span>używane są przez sterowniki, takie jak <span +class="ec-lmss-10">dvips </span>czy <span +class="ec-lmss-10">xdvi</span>. W tym wypadku +wynik przeszukiwania okaże się pusty, ponieważ w systemie brak gotowych wygenerowanych czcionek „<span +class="ec-lmtt-10">.pk</span>” +Computer Modern (wynika to z faktu używania w <span class="TEX">T<span +class="E">E</span>X</span> Live fontów PostScript-owych Type1). +<div class="alltt"> +<!--l. 2663--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> wsuipa10.pk</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk</span> +</div> +</div> Dla tych fontów (alfabetu fonetycznego) musieliśmy wygenerować pliki „<span +class="ec-lmtt-10">.pk</span>”, a ponieważ domyślnym +Metafont-owym trybem naszej instalacji jest <span +class="ec-lmtt-10">ljfour </span>z podstawową rozdzielczością 600dpi, zwracany jest taki +właśnie wynik. <div class="alltt"> +<!--l. 2673--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> -dpi=300</span><span +class="ec-lmtk-10"> wsuipa10.pk</span> +</div> +</div> W tym wypadku, kiedy zaznaczamy, że interesuje nas rozdzielczość 300dpi (<span +class="ec-lmtt-10">-dpi=300</span>), to widzimy, że +w naszej instalacji taka czcionka nie jest dostępna. Program taki jak <span +class="ec-lmss-10">dvips </span>czy <span +class="ec-lmss-10">xdvi </span>zatrzymałby się, aby +utworzyć pliki <span +class="ec-lmtt-10">.pk </span>w wymaganej rozdzielczości (używając skryptu <span +class="ec-lmss-10">mktexpk</span>). +<!--l. 2683--><p class="indent" > Przeanalizujmy teraz pliki nagłówkowe i konfiguracyjne programu <span +class="ec-lmss-10">dvips</span>. Najpierw szukamy pliku +PostScript-owego prologu <span +class="ec-lmtt-10">tex.pro</span>, wykorzystywanego dla potrzeb <span class="TEX">T<span +class="E">E</span>X</span>-a. Drugi przykład pokazuje +poszukiwanie pliku konfiguracyjnego <span +class="ec-lmtt-10">config.ps</span>, zaś trzeci – szukanie pliku mapy czcionek PostScriptowych +<span +class="ec-lmtt-10">psfonts.map </span>(począwszy od obecnej edycji, pliki <span +class="ec-lmtt-10">.map </span>i <span +class="ec-lmtt-10">.enc </span>mają własne reguły przeszukiwania ścieżek +i zmienione położenie w ramach drzew <span +class="ec-lmtt-10">texmf</span>). Ponieważ rozszerzenie „<span +class="ec-lmtt-10">.ps</span>” nie jest jednoznaczne, +musimy wyraźnie zaznaczyć, jaki typ jest wymagany dla pliku <span +class="ec-lmtt-10">config.ps </span>(„<span +class="ec-lmtt-10">dvips config</span>”). +<div class="alltt"> +<!--l. 2695--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> tex.pro</span> +<br /><span +class="ec-lmtt-10">/usr/local/texmf/dvips/base/tex.pro</span> +<br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> --format="dvips</span><span +class="ec-lmtk-10"> config"</span><span +class="ec-lmtk-10"> config.ps</span> +<br /><span +class="ec-lmtt-10">/usr/local/texmf-var/dvips/config/config.ps</span> +<br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> psfonts.map</span> +<br /><span +class="ec-lmtt-10">/usr/local/texmf-var/fonts/map/dvips/updmap/psfonts.map</span> + + +</div> +</div> +<!--l. 2704--><p class="indent" > Następnie przyjrzyjmy się bliżej plikom pomocniczym fontów Times z kolekcji URW. W standardzie +nazewnictwa fontów mają one prefiks „<span +class="ec-lmtt-10">utm</span>”. Pierwszy plik, którego szukamy, to plik konfiguracyjny, +zawierający nazwę pliku z przemapowaniem fontów: <div class="alltt"> +<!--l. 2708--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> --format="dvips</span><span +class="ec-lmtk-10"> config"</span><span +class="ec-lmtk-10"> config.utm</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /usr/local/texmf-dist/dvips/psnfss/config.utm</span> +</div> +</div> W pliku tym znajduje się wiersz: <div class="alltt"> +<!--l. 2713--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> p</span><span +class="ec-lmtt-10"> +utm.map</span> +</div> +</div> wskazujący na plik <span +class="ec-lmtt-10">utm.map</span>, który chcemy zlokalizować w następnej kolejności: <div class="alltt"> +<!--l. 2718--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> utm.map</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /usr/local/texmf-dist/fonts/map/dvips/times/utm.map</span> +</div> +</div> Plik z przemapowaniem definiuje nazwy czcionek PostScriptowych Type1 w zestawie fontów URW, zaś jego +zawartość wygląda następująco (pokazane są tylko fragmenty wierszy): <div class="alltt"> +<!--l. 2725--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">utmb8r</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> NimbusRomNo9L-Medi</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> ...</span><span +class="ec-lmtt-10"> <utmb8a.pfb</span> +<br /><span +class="ec-lmtt-10">utmbi8r</span><span +class="ec-lmtt-10"> NimbusRomNo9L-MediItal...</span><span +class="ec-lmtt-10"> <utmbi8a.pfb</span> +<br /><span +class="ec-lmtt-10">utmr8r</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> NimbusRomNo9L-Regu</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> ...</span><span +class="ec-lmtt-10"> <utmr8a.pfb</span> +<br /><span +class="ec-lmtt-10">utmri8r</span><span +class="ec-lmtt-10"> NimbusRomNo9L-ReguItal...</span><span +class="ec-lmtt-10"> <utmri8a.pfb</span> +<br /><span +class="ec-lmtt-10">utmbo8r</span><span +class="ec-lmtt-10"> NimbusRomNo9L-Medi</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> ...</span><span +class="ec-lmtt-10"> <utmb8a.pfb</span> +<br /><span +class="ec-lmtt-10">utmro8r</span><span +class="ec-lmtt-10"> NimbusRomNo9L-Regu</span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> ...</span><span +class="ec-lmtt-10"> <utmr8a.pfb</span> +</div> +</div> Używając przeszukiwania plików z fontami Type1, znajdźmy font Times Roman <span +class="ec-lmtt-10">utmr8a.pfb </span>w drzewie +katalogów <span +class="ec-lmtt-10">texmf</span>: <div class="alltt"> +<!--l. 2735--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">kpsewhich</span><span +class="ec-lmtk-10"> utmr8a.pfb</span> +<br /><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtt-10"> /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb</span> +</div> +</div> +<!--l. 2742--><p class="indent" > Powyższe przykłady pokazują, jak łatwo można znajdować lokalizację danego pliku. Jest to ważne +zwłaszcza wówczas, gdy istnieje podejrzenie, że gdzieś zawieruszyła się błędna wersja jakiegoś pliku; <span +class="ec-lmss-10">kpsewhich</span> +pokaże tylko pierwszy napotkany plik. +<!--l. 2747--><p class="noindent" > + <h5 class="subsubsectionHead"><span class="titlemark">8.2.4. </span> <a + id="x1-700008.2.4"></a>Diagnostyka błędów</h5> +<!--l. 2750--><p class="noindent" >Czasami niezbędne są informacje o tym, jak program sobie radzi z odniesieniami do plików. Aby dało się je +uzyskać w wygodny sposób, Kpathsea oferuje różne poziomy diagnostyki błędów: + <ul class="itemize1"> + <li class="itemize">wywołania <span +class="ec-lmtt-10">stat </span>(testy pliku). Podczas uruchamiania z uaktualnioną bazą danych <span +class="ec-lmtt-10">ls-R </span>nie + powinno to przeważnie dawać żadnego wyniku. + + + </li> + <li class="itemize">Zapis odwołań do tablic asocjacyjnych (<span +class="ec-lmri-10">hash tables</span>), takich jak baza <span +class="ec-lmtt-10">ls-R</span>, pliki przemapowań, + pliki konfiguracyjne. + </li> + <li class="itemize">Operacje otwarcia i zamknięcia pliku. + </li> + <li class="itemize">Ogólne informacje o ścieżkach dla typów plików szukanych przez Kpathsea; użyteczne do + znalezienia ścieżki zdefiniowanej dla danego pliku. + </li> + <li class="itemize">Lista katalogów dla każdego z elementów ścieżki (odnosi się tylko do poszukiwań na dysku). + </li> + <li class="itemize">Poszukiwania plików.</li></ul> +<!--l. 2767--><p class="noindent" >Wartość <span +class="ec-lmtt-10">-1 </span>ustawia wszystkie powyższe opcje – w praktyce, poszukując przyczyny błędów, prawdopodobnie +będziesz zawsze używać tych poziomów. +<!--l. 2771--><p class="indent" > Podobnie w przypadku programu <span +class="ec-lmss-10">dvips</span>, ustawiając kombinację przełączników wykrywania błędów, można +dokładnie śledzić, skąd pochodzą pliki. W sytuacji gdy plik nie zostanie odnaleziony, widać, +w których katalogach program szukał danego pliku, dzięki czemu można się zorientować, w czym +problem. +<!--l. 2777--><p class="indent" > Ogólnie mówiąc, ponieważ programy odwołują się wewnętrznie do biblioteki Kpathsea, opcje wykrywania +błędów można wybrać przy użyciu zmiennej środowiskowej <span +class="ec-lmtt-10">KPATHSEA_DEBUG</span>, ustawiając ją na opisaną +powyżej wartość (kombinację wartości). +<!--l. 2782--><p class="noindent" ><span +class="ec-lmbx-10">Uwaga dla u</span><span +class="ec-lmbx-10">żytkownik</span><span +class="ec-lmbx-10">ów Windows: </span>w systemie tym niełatwo przekierować komunikaty programu do +pliku. Do celów diagnostycznych można chwilowo ustawić zmienne (w oknie CMD): + + + <div class="verbatim" id="verbatim-8"> + <div class="fancyvrb" id="fancyvrb21"><a + id="x1-70002r1"></a>  SET KPATHSEA_DEBUG_OUTPUT=err.log<br class="fancyvrb" /><a + id="x1-70004r2"></a>  SET KPATHSEA_DEBUG=-1</div> +</div> +<!--l. 2789--><p class="nopar" > +<!--l. 2791--><p class="indent" > Rozważmy na przykład mały <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>-owy plik źródłowy <span +class="ec-lmtt-10">hello-world.tex</span>, który zawiera: + + + <div class="verbatim" id="verbatim-9"> + <div class="fancyvrb" id="fancyvrb22"><a + id="x1-70006r1"></a>    \documentclass{article}<br class="fancyvrb" /><a + id="x1-70008r2"></a>    \begin{document}<br class="fancyvrb" /><a + id="x1-70010r3"></a>    Hello World!<br class="fancyvrb" /><a + id="x1-70012r4"></a>    \end{document}</div> +</div> +<!--l. 2798--><p class="nopar" >Ten mały plik korzysta jedynie z fontu <span +class="ec-lmtt-10">cmr10</span>. Przyjrzyjmy się, jak <span +class="ec-lmss-10">dvips </span>przygotowuje plik PostScript-owy +(chcemy użyć wersji Type1 fontu Computer Modern, stąd opcja <span +class="ec-lmtt-10">-Pcms</span>). <div class="alltt"> +<!--l. 2802--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">dvips</span><span +class="ec-lmtk-10"> -d4100</span><span +class="ec-lmtk-10"> hello-world</span><span +class="ec-lmtk-10"> -Pcms</span><span +class="ec-lmtk-10"> -o</span> +</div> +</div> Mamy tu do czynienia jednocześnie z czwartą klasą wykrywania błędów programu <span +class="ec-lmss-10">dvips </span>(ścieżki +fontowe) oraz z rozwijaniem elementu ścieżki przez Kpathsea (patrz: <span +class="ec-lmri-10">Dvips Reference Manual</span>, +<a +href="../../../../texmf/doc/dvips/dvips.pdf" >texmf/doc/dvips/dvips.pdf</a>). Komunikaty z uruchomienia programu (nieco zmodyfikowane) znajdują się +na rys. <a +href="#x1-70035r12">12<!--tex4ht:ref: fig:dvipsdbga --></a>. +<!--l. 2811--><p class="indent" > <a + id="x1-70035r12"></a><a + id="x1-70040r13"></a><a + id="x1-70053r14"></a><hr class="float"><div class="float" +> + + +<div class="BVerbatimInput"><span +class="ec-lmtt-9">debug:start</span><span +class="ec-lmtt-9"> search(file=texmf.cnf,</span><span +class="ec-lmtt-9"> must_exist=1,</span><span +class="ec-lmtt-9"> find_all=1,</span><br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:/usr/local/bin/texlive:/usr/local/bin:</span><br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> /usr/local/bin/texmf/web2c:/usr/local:</span><br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> /usr/local/texmf/web2c:/.:/./teTeX/TeX/texmf/web2c:).</span><br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=ls-R,</span><span +class="ec-lmtt-9"> must_exist=1,</span><span +class="ec-lmtt-9"> find_all=1,</span><br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=~/tex:/usr/local/texmf).</span><br /><span +class="ec-lmtt-9">kdebug:search(ls-R)</span><span +class="ec-lmtt-9"> =>/usr/local/texmf/ls-R</span><br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=aliases,</span><span +class="ec-lmtt-9"> must_exist=1,</span><span +class="ec-lmtt-9"> find_all=1,</span><br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=~/tex:/usr/local/texmf).</span><br /><span +class="ec-lmtt-9">kdebug:search(aliases)</span><span +class="ec-lmtt-9"> =></span><span +class="ec-lmtt-9"> /usr/local/texmf/aliases</span><br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=config.ps,</span><span +class="ec-lmtt-9"> must_exist=0,</span><span +class="ec-lmtt-9"> find_all=0,</span><br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex:!!/usr/local/texmf/dvips//).</span><br /><span +class="ec-lmtt-9">kdebug:search(config.ps)</span><span +class="ec-lmtt-9"> =></span><span +class="ec-lmtt-9"> /usr/local/texmf/dvips/config/config.ps</span><br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=/root/.dvipsrc,</span><span +class="ec-lmtt-9"> must_exist=0,</span><span +class="ec-lmtt-9"> find_all=0,</span><br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex:!!/usr/local/texmf/dvips//).</span><br /><span +class="ec-lmtt-9">search(file=/home/goossens/.dvipsrc,</span><span +class="ec-lmtt-9"> must_exist=1,</span><span +class="ec-lmtt-9"> find_all=0,</span><br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//).</span><br /><span +class="ec-lmtt-9">kdebug:search($HOME/.dvipsrc)</span><span +class="ec-lmtt-9"> =></span><br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=config.cms,</span><span +class="ec-lmtt-9"> must_exist=0,</span><span +class="ec-lmtt-9"> find_all=0,</span><br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//).</span><br /><span +class="ec-lmtt-9">kdebug:search(config.cms)</span><br /><span +class="ec-lmtt-9">=>/usr/local/texmf/dvips/cms/config.cms</span></div> + <div class="caption" +><span class="id">Rysunek 12: </span><span +class="content">Szukanie pliku konfiguracyjnego</span></div><!--tex4ht:label?: x1-70035r12 --> +<div class="BVerbatimInput"><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=texc.pro,</span><span +class="ec-lmtt-9"> must\_exist=0,</span><span +class="ec-lmtt-9"> find\_all=0,</span><br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:</span><br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).</span><br /><span +class="ec-lmtt-9">kdebug:search(texc.pro)</span><span +class="ec-lmtt-9"> =></span><span +class="ec-lmtt-9"> /usr/local/texmf/dvips/base/texc.pro</span></div> + <div class="caption" +><span class="id">Rysunek 13: </span><span +class="content">Szukanie pliku prologu</span></div><!--tex4ht:label?: x1-70040r13 --> +<div class="BVerbatimInput"><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=cmr10.tfm,</span><span +class="ec-lmtt-9"> must\_exist=1,</span><span +class="ec-lmtt-9"> find\_all=0,</span><br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:</span><br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> /var/tex/fonts/tfm//).</span><br /><span +class="ec-lmtt-9">kdebug:search(cmr10.tfm)</span><span +class="ec-lmtt-9"> =></span><span +class="ec-lmtt-9"> /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm</span><br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=texps.pro,</span><span +class="ec-lmtt-9"> must\_exist=0,</span><span +class="ec-lmtt-9"> find\_all=0,</span><br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> ...</span><br /><span +class="ec-lmtt-9"><texps.pro></span><br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=cmr10.pfb,</span><span +class="ec-lmtt-9"> must\_exist=0,</span><span +class="ec-lmtt-9"> find\_all=0,</span><br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:</span><br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).</span><br /><span +class="ec-lmtt-9">kdebug:search(cmr10.pfb)</span><span +class="ec-lmtt-9"> =></span><span +class="ec-lmtt-9"> /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb</span><br /><span +class="ec-lmtt-9"><cmr10.pfb>[1]</span></div> + <div class="caption" +><span class="id">Rysunek 14: </span><span +class="content">Szukanie pliku fontu</span></div><!--tex4ht:label?: x1-70053r14 --> + + + </div><hr class="endfloat" /> +<!--l. 2826--><p class="indent" > Program <span +class="ec-lmss-10">dvips </span>zaczyna pracę od zlokalizowania potrzebnych mu plików. Najpierw znajduje plik <span +class="ec-lmtt-10">texmf.cnf</span>, +który zawiera ścieżki przeszukiwania dla innych plików. Potem znajduje bazę danych <span +class="ec-lmtt-10">ls-R </span>(w celu +optymalizacji szukania plików), następnie plik <span +class="ec-lmtt-10">aliases</span>, który umożliwia deklarowanie różnych nazw (np. +krótkie DOS-owe „8.3” i bardziej naturalne dłuższe wersje) dla tych samych plików. Następnie +<span +class="ec-lmss-10">dvips </span>znajduje podstawowy plik konfiguracyjny <span +class="ec-lmtt-10">config.ps</span>, zanim poszuka pliku z ustawieniami +użytkownika <span +class="ec-lmtt-10">.dvipsrc </span>(który w tym wypadku <span +class="ec-lmri-10">nie </span>zostaje odnaleziony). W końcu <span +class="ec-lmss-10">dvips </span>lokalizuje plik +konfiguracyjny <span +class="ec-lmtt-10">config.cms </span>dla fontów PostScript-owych Computer Modern (jest to inicjowane przez +dodanie parametru <span +class="ec-lmtt-10">-Pcms </span>przy uruchamianiu programu). Plik ten zawiera listę plików z „mapami”, +które definiują relacje pomiędzy <span class="TEX">T<span +class="E">E</span>X</span>-owymi, PostScript-owymi i systemowymi nazwami fontów. +<div class="alltt"> +<!--l. 2840--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">more</span><span +class="ec-lmtk-10"> /usr/local/texmf/dvips/config/config.cms</span> +<br /><span +class="ec-lmtt-10">p</span><span +class="ec-lmtt-10"> +ams.map</span> +<br /><span +class="ec-lmtt-10">p</span><span +class="ec-lmtt-10"> +cms.map</span> +<br /><span +class="ec-lmtt-10">p</span><span +class="ec-lmtt-10"> +cmbkm.map</span> +<br /><span +class="ec-lmtt-10">p</span><span +class="ec-lmtt-10"> +amsbkm.map</span> +</div> +</div> W ten sposób <span +class="ec-lmss-10">dvips </span>wyszukuje wszystkie te pliki oraz główny plik z przemapowaniem <span +class="ec-lmtt-10">psfonts.map</span>, który +ładowany jest domyślnie (zawiera on deklaracje często używanych fontów postscriptowych; więcej szczegółów +na temat postscriptowych plików przemapowań fontów można znaleźć w ostatniej części rozdziału +<a +href="#x1-690008.2.3">8.2.3<!--tex4ht:ref: SExamplesofuse --></a>). +<!--l. 2854--><p class="indent" > W tym miejscu <span +class="ec-lmss-10">dvips </span>zgłasza się użytkownikowi: <div class="alltt"> +<!--l. 2855--><p class="noindent" ><div class="obeylines-v"> +<br /><span +class="ec-lmtt-10">This</span><span +class="ec-lmtt-10"> is</span><span +class="ec-lmtt-10"> dvips</span><span +class="ec-lmtt-10"> 5.92b</span><span +class="ec-lmtt-10"> Copyright</span><span +class="ec-lmtt-10"> 2002</span><span +class="ec-lmtt-10"> Radical</span><span +class="ec-lmtt-10"> Eye</span><span +class="ec-lmtt-10"> Software</span><span +class="ec-lmtt-10"> (www.radicaleye.com)</span> +</div> +</div>…potem szuka pliku prologu <span +class="ec-lmtt-10">texc.pro</span>: <div class="alltt"> +<!--l. 2861--><p class="noindent" ><div class="obeylines-v"> +<br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=texc.pro,</span><span +class="ec-lmtt-9"> must_exist=0,</span><span +class="ec-lmtt-9"> find_all=0,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).</span> +<br /><span +class="ec-lmtt-9">kdebug:search(texc.pro)</span><span +class="ec-lmtt-9"> =></span><span +class="ec-lmtt-9"> /usr/local/texmf/dvips/base/texc.pro</span> +</div> +</div> Po znalezieniu szukanego pliku <span +class="ec-lmss-10">dvips </span>podaje datę i czas oraz informuje o generowaniu pliku <span +class="ec-lmtt-10">hello-world.ps</span>. +Ponieważ potrzebuje pliku z fontem <span +class="ec-lmtt-10">cmr10</span>, a jest on zadeklarowany jako dostępny, wyświetla komunikat: +<div class="alltt"> +<!--l. 2876--><p class="noindent" ><div class="obeylines-v"> +<br /><span +class="ec-lmtt-9">TeX</span><span +class="ec-lmtt-9"> output</span><span +class="ec-lmtt-9"> 1998.02.26:1204’</span><span +class="ec-lmtt-9"> -></span><span +class="ec-lmtt-9"> hello-world.ps</span> +<br /><span +class="ec-lmtt-9">Defining</span><span +class="ec-lmtt-9"> font</span><span +class="ec-lmtt-9"> ()</span><span +class="ec-lmtt-9"> cmr10</span><span +class="ec-lmtt-9"> at</span><span +class="ec-lmtt-9"> 10.0pt</span> +<br /><span +class="ec-lmtt-9">Font</span><span +class="ec-lmtt-9"> cmr10</span><span +class="ec-lmtt-9"> <CMR10></span><span +class="ec-lmtt-9"> is</span><span +class="ec-lmtt-9"> resident.</span> +</div> +</div> Teraz trwa poszukiwanie pliku <span +class="ec-lmtt-10">cmr10.tfm</span>, który zostaje znaleziony, po czym <span +class="ec-lmss-10">dvips </span>powołuje się na kilka +innych plików startowych (nie pokazanych). W końcu przykładowy font Type1 <span +class="ec-lmtt-10">cmr10.pfb </span>zostaje +zlokalizowany i dołączony do pliku wynikowego (patrz ostatnia linia): <div class="alltt"> +<!--l. 2885--><p class="noindent" ><div class="obeylines-v"> +<br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=cmr10.tfm,</span><span +class="ec-lmtt-9"> must_exist=1,</span><span +class="ec-lmtt-9"> find_all=0,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> /var/tex/fonts/tfm//).</span> +<br /><span +class="ec-lmtt-9">kdebug:search(cmr10.tfm)</span><span +class="ec-lmtt-9"> =></span><span +class="ec-lmtt-9"> /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm</span> + + +<br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=texps.pro,</span><span +class="ec-lmtt-9"> must_exist=0,</span><span +class="ec-lmtt-9"> find_all=0,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> ...</span> +<br /><span +class="ec-lmtt-9"><texps.pro></span> +<br /><span +class="ec-lmtt-9">kdebug:start</span><span +class="ec-lmtt-9"> search(file=cmr10.pfb,</span><span +class="ec-lmtt-9"> must_exist=0,</span><span +class="ec-lmtt-9"> find_all=0,</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:</span> +<br /><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> </span><span +class="ec-lmtt-9"> ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).</span> +<br /><span +class="ec-lmtt-9">kdebug:search(cmr10.pfb)</span><span +class="ec-lmtt-9"> =></span><span +class="ec-lmtt-9"> /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb</span> +<br /><span +class="ec-lmtt-9"><cmr10.pfb>[1]</span> +</div> +</div> + <h4 class="subsectionHead"><span class="titlemark">8.3. </span> <a + id="x1-710008.3"></a>Parametry kontrolujące działanie programów</h4> +<!--l. 2901--><p class="noindent" >Inną użyteczną cechą Web2C jest możliwość ustalania wielu parametrów określających wielkość pamięci za +pomocą pliku <span +class="ec-lmtt-10">texmf.cnf</span>. Ustawienia wszystkich parametrów znajdują się w części trzeciej pliku. +Najważniejszymi zmiennymi są: + <dl class="description"><dt class="description"> +<span +class="ec-lmtk-10">main_memory</span> </dt><dd +class="description">Całkowita wielkość pamięci dostępnej dla <span class="TEX">T<span +class="E">E</span>X</span>-a, Metafont-a i MetaPost-a. Dla każdego + nowego ustawienia tej zmiennej należy wykonać nowy format. + </dd><dt class="description"> +<span +class="ec-lmtk-10">extra_mem_bot</span> </dt><dd +class="description">Dodatkowa wielkość pamięci przeznaczonej na „duże” struktury danych <span class="TEX">T<span +class="E">E</span>X</span>-a, takie + jak: pudełka, kleje itd.; przydatna zwłaszcza w wypadku korzystania z pakietu PI C<span class="TEX">T<span +class="E">E</span>X</span>. + </dd><dt class="description"> +<span +class="ec-lmtk-10">font_mem_size</span> </dt><dd +class="description">Wielkość pamięci przeznaczonej przez <span class="TEX">T<span +class="E">E</span>X</span>-a na informacje o fontach. Jest to mniej + więcej ogólna wielkość wczytywanych przez <span class="TEX">T<span +class="E">E</span>X</span>-a plików TFM. + </dd><dt class="description"> +<span +class="ec-lmtk-10">hash_extra</span> </dt><dd +class="description">Dodatkowa wielkość pamięci przeznaczonej na tablicę zawierającą nazwy instrukcji. + Tablica główna może zmieścić w przybliżeniu 10000 nazw; wielkość ta może się okazać + zbyt mała, np. w wypadku obszernej książki zawierającej liczne odsyłacze. Domyślna wartość + <span +class="ec-lmtt-10">hash_extra </span>to <span +class="ec-lmtt-10">50000</span>.</dd></dl> +<!--l. 2934--><p class="noindent" >Oczywiście powyższa możliwość nie zastąpi prawdziwej, dynamicznej alokacji pamięci. Jest to jednak niezwykle +trudne do zaimplementowania w obecnej wersji <span class="TEX">T<span +class="E">E</span>X</span>-a i dlatego powyższe parametry stanowią praktyczny +kompromis, pozwalając na pewną elastyczność. +<!--l. 2940--><p class="indent" > Należy tu jednak nadmienić, iż nie wszystkie programy korzystają z tych zmiennych. Np. Lua<span class="TEX">T<span +class="E">E</span>X</span> posiada +nowoczesną, w pełni dynamiczną alokację pamięci, a zatem powyższe zmienne są w tym przypadku po prostu +ignorowane. +<!--l. 2947--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">9. </span> <a + id="x1-720009"></a>Budowa systemu na nowej platformie uniksowej</h3> +<!--l. 2948--><p class="noindent" >Jeżeli mamy do czynienia z platformą, dla której nie są dostarczone binaria, trzeba będzie skompilować +<span class="TEX">T<span +class="E">E</span>X</span>-a oraz towarzyszące mu programy. Nie jest to takie trudne, jak się wydaje. Wszystko czego potrzebujemy, +znajduje się na DVD w katalogu <span +class="ec-lmtt-10">source</span>. +<!--l. 2954--><p class="indent" > Najpierw należy zainstalować główne drzewo plików <span class="TEX">T<span +class="E">E</span>X</span>-owych z <span class="TEX">T<span +class="E">E</span>X</span> Live DVD (najlepiej wykonać +instalację podstawową, bez wybierania binariów systemowych). +<!--l. 2958--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">9.1. </span> <a + id="x1-730009.1"></a>Warunki wstępne</h4> +<!--l. 2959--><p class="noindent" >Do skompilowania całego <span class="TEX">T<span +class="E">E</span>X</span>-a i jego programów pomocniczych potrzeba około 100 megabajtów wolnego +miejsca na dysku. Potrzebny jest także kompilator ANSI C, oprogramowanie <span +class="ec-lmss-10">make</span>, skaner leksykalny oraz +generator parserów. Programy użytkowe GNU (<span +class="ec-lmss-10">gcc</span>, GNU <span +class="ec-lmss-10">make</span>, <span +class="ec-lmss-10">m4</span>, <span +class="ec-lmss-10">flex</span>, <span +class="ec-lmss-10">bison</span>) są najlepiej przetestowanymi +na różnych platformach. Poprawnie powinny pracować <span +class="ec-lmss-10">gcc</span>-2.7.*, <span +class="ec-lmss-10">flex</span>-2.4.7 i GNU <span +class="ec-lmss-10">make</span>-3.72.1 lub +nowszy. Można też korzystać z innych kompilatorów C i programów <span +class="ec-lmss-10">make</span>, wymaga to jednak +dobrego zrozumienia zasad tworzenia programów uniksowych, aby poradzić sobie z ewentualnymi +problemami. + + +<!--l. 2974--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">9.2. </span> <a + id="x1-740009.2"></a>Konfiguracja</h4> +<!--l. 2975--><p class="noindent" >Należy rozpakować źródła ze skompresowanego pliku <span +class="ec-lmtt-10">tar </span>z katalogu <span +class="ec-lmtt-10">source </span>na twardy dysk, a potem przejść +do katalogu, do którego zostały one skopiowane. Teraz trzeba się zdecydować, gdzie będzie główny katalog +instalacji, np. <span class="path"><span +class="ec-lmtt-10">/usr/TeX</span></span> lub <span class="path"><span +class="ec-lmtt-10">/usr/local/TeX</span></span>. Naturalnie, należy użyć tej samej lokalizacji, która została +użyta podczas instalacji głównego drzewa <span class="TEX">T<span +class="E">E</span>X</span>-owego. +<!--l. 2983--><p class="indent" > Uruchomić <span +class="ec-lmss-10">configure </span>z linii poleceń: <div class="alltt"> +<!--l. 2984--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">./configure</span><span +class="ec-lmtk-10"> --prefix=/usr/local/TeX</span> +</div> +</div> +<!--l. 2988--><p class="indent" > Katalog „prefix” to ten, w którym zainstalowane zostało główne drzewo <span class="TEX">T<span +class="E">E</span>X</span>-owe. Zostanie użyty +następujący układ katalogów (<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">$TEXDIR</span></span></span> oznacza wybrany powyżej katalog): +<!--l. 2992--><p class="noindent" ><!--tex4ht:inline--><div class="tabular"> <table id="TBL-4" class="tabular" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-4-1g"><col +id="TBL-4-1"><col +id="TBL-4-2"></colgroup><tr + style="vertical-align:baseline;" id="TBL-4-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-1-1" +class="td11"> <span +class="ec-lmtt-10">$TEXDIR/man </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-1-2" +class="td10"> strony manuala uniksowego, </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-2-1" +class="td11"> <span +class="ec-lmtt-10">$TEXDIR/share/texmf </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-2-2" +class="td10"> główne drzewo <span class="TEX">T<span +class="E">E</span>X</span>-owe, zawierające makra itp.,</td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-3-1" +class="td11"> <span +class="ec-lmtt-10">$TEXDIR/info </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-3-2" +class="td10"> podręczniki w formacie GNU info, </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-4-1" +class="td11"> <span +class="ec-lmtt-10">$TEXDIR/bin/$PLATFORM </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-4-2" +class="td10"> binaria </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-5-1" +class="td11"> </td></tr></table></div> +<!--l. 3003--><p class="indent" > Można uniknąć stosowania „<span +class="ec-lmtt-10">share/</span>” przed katalogiem <span +class="ec-lmtt-10">texmf</span>, ponieważ <span +class="ec-lmtt-10">$TEXDIR/share/texmf</span> +i <span +class="ec-lmtt-10">$TEXDIR/texmf </span>są wykrywane automatycznie przez skrypt <span +class="ec-lmss-10">configure</span>. W razie wybrania innego katalogu, +trzeba ten katalog wyszczególnić parametrem <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">--datadir</span></span></span> skryptu <span +class="ec-lmss-10">configure</span>. +<!--l. 3009--><p class="indent" > Jeżeli nie chcemy używać katalogu <span +class="ec-lmtt-10">$PLATFORM </span>(a więc umieścić binaria bezpośrednio w <span +class="ec-lmtt-10">$TEXDIR/bin</span>), to +w wywołaniu skryptu <span +class="ec-lmss-10">configure </span>należy użyć parametru <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">--disable-multiplatform</span></span></span>. +<!--l. 3014--><p class="indent" > Więcej dostępnych parametrów (np. pomijanie pakietów opcjonalnych, takich jak Omega) można zobaczyć, +uruchamiając <span +class="ec-lmtt-10">./configure --help</span>. +<!--l. 3018--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">9.3. </span> <a + id="x1-750009.3"></a>Uruchamianie <span +class="ec-lmss-10">make</span></h4> +<!--l. 3019--><p class="noindent" >Po upewnieniu się, że nie jest ustawiona zmienna powłoki <span +class="ec-lmtt-10">noclobber</span>, należy napisać: <div class="alltt"> +<!--l. 3021--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">make</span><span +class="ec-lmtk-10"> world</span> +</div> +</div> i …zaparzyć sobie kawę. +<!--l. 3026--><p class="indent" > Może się też przydać zapisanie całego procesu kompilacji w pliku <span +class="ec-lmtt-10">.log</span>: <div class="alltt"> +<!--l. 3028--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">sh</span><span +class="ec-lmtk-10"> -c</span><span +class="ec-lmtk-10"> "make</span><span +class="ec-lmtk-10"> world</span><span +class="ec-lmtk-10"> >world.log</span><span +class="ec-lmtk-10"> 2>&1"</span><span +class="ec-lmtk-10"> &</span> +</div> +</div> Zanim stwierdzimy, że wszystko jest w porządku, warto sprawdzić, czy w pliku <span +class="ec-lmtt-10">.log </span>nie ma komunikatów +błędów (kiedy polecenie zwraca kod błędu, GNU <span +class="ec-lmss-10">make </span>zawsze używa sekwencji „<span +class="ec-lmtt-10">***</span>”), i czy utworzone +zostały wszystkie binaria: <div class="alltt"> +<!--l. 3035--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">cd</span><span +class="ec-lmtk-10"> </span><span +class="ec-lmro-10">TEXDIR</span><span +class="ec-lmtk-10">/bin/</span><span +class="ec-lmro-10">archname</span> +<br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">ls</span><span +class="ec-lmtk-10"> |</span><span +class="ec-lmtk-10"> wc</span> +</div> +</div> Oczekiwanym rezultatem jest ponad 200. Polecenie <span +class="ec-lmtt-10">make world </span>jest równoważne z <span +class="ec-lmtt-10">make all install</span> +<span +class="ec-lmtt-10">strip</span>. Jeśli do uruchamiania <span +class="ec-lmtt-10">make install </span>potrzebne są specjalne uprawnienia, można uruchomić dwie +oddzielne sesje <span +class="ec-lmss-10">make</span>: <div class="alltt"> + + +<!--l. 3043--><p class="noindent" ><div class="obeylines-v"> +<span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">make</span><span +class="ec-lmtk-10"> all</span> +<br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">su</span> +<br /><span +class="ec-lmtt-10">></span><span +class="ec-lmtt-10"> </span><span +class="ec-lmtk-10">make</span><span +class="ec-lmtk-10"> install</span><span +class="ec-lmtk-10"> strip</span> +</div> +</div> +<!--l. 3049--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">9.4. </span> <a + id="x1-760009.4"></a>Końcowe kroki konfiguracyjne</h4> +<!--l. 3050--><p class="noindent" >Należy uaktualnić zmienną <span +class="ec-lmtt-10">PATH </span>o nazwę katalogu zawierającego właśnie zainstalowane binaria +(np. <span +class="ec-lmtt-10">/usr/local/TeX/bin/mips-sgi-irix6.3</span>); podobnie postąpić trzeba z <span +class="ec-lmtt-10">MANPATH </span>i <span +class="ec-lmtt-10">INFOPATH </span>i dołączyć +do nich odpowiednie nazwy podkatalogów, tj. <span +class="ec-lmtt-10">$TEXDIR/man </span>oraz <span +class="ec-lmtt-10">$TEXDIR/info</span>. Patrz część <a +href="#x1-320003.4">3.4<!--tex4ht:ref: sec:postinstall --></a> +(str. <a +href="#x1-320003.4">37<!--tex4ht:ref: sec:postinstall --></a>). +<!--l. 3058--><p class="indent" > Jeśli zechcesz udostępnić skompilowane przez siebie programy, skontaktuj się z nami (<a +href="tex-live@tug.org" class="url" ><span +class="ec-lmtt-10">tex-live@tug.org</span></a>); +chętnie umieścimy je na stronie <span class="TEX">T<span +class="E">E</span>X</span> Live. +<!--l. 3063--><p class="indent" > <a id="ack"></a> + <h3 class="sectionHead"><span class="titlemark">10. </span> <a + id="x1-7700010"></a>Podziękowania</h3> +<!--l. 3066--><p class="noindent" ><span class="TEX">T<span +class="E">E</span>X</span> Live jest wspólnym dziełem prawie wszystkich grup <span class="TEX">T<span +class="E">E</span>X</span>-owych. Niniejsza edycja <span class="TEX">T<span +class="E">E</span>X</span> Live została +opracowana pod kierownictwem Karla Berry’ego, przy głównym współudziale: + <ul class="itemize1"> + <li class="itemize">grup <span class="TEX">T<span +class="E">E</span>X</span>-owych: międzynarodowej, niemieckiej, holenderskiej i polskiej (odpowiednio: TUG, + DANTE e.V., NTG, i GUST), które wspólnie zapewniają potrzebną infrastrukturę techniczną + i organizacyjną. Dołącz do swojej grupy <span class="TEX">T<span +class="E">E</span>X</span>-owej!; + </li> + <li class="itemize">zespołu CTAN (w szczególności Robina Fairbairnsa, Jima Hefferona i Rainera Schöpfa), który + dystrybuuje obrazy płyt <span class="TEX">T<span +class="E">E</span>X</span> Live i udostępnia wspólną infrastrukturę służącą aktualizacji + pakietów, od której zależy <span class="TEX">T<span +class="E">E</span>X</span> Live; + </li> + <li class="itemize">Nelsona Beebe, za umożliwienie dostępu do wielu platform ekipie <span class="TEX">T<span +class="E">E</span>X</span> Live i pomoc w testowaniu; + </li> + <li class="itemize">Johna Bowmana, który dostosował swój zaawansowany program Asymptote do współpracy z TL; + </li> + <li class="itemize">Petera Breitenlohnera i zespołu e-<span class="TEX">T<span +class="E">E</span>X</span>, którzy stworzyli stabilną podstawę przyszłych wersji + <span class="TEX">T<span +class="E">E</span>X</span>-a (Peter dodatkowo służy nieustanną pomocą w wykorzystaniu narzędzi autotools w <span class="TEX">T<span +class="E">E</span>X</span> + Live); + </li> + <li class="itemize">Jin-Hwan Cho i całego zespołu DVIPDFM<span +class="lmmi-10">x </span>za ten znakomity sterownik i nieustanną pomoc + w rozwiązywaniu problemów z konfiguracją; + </li> + <li class="itemize">Thomasa Essera, autora wspaniałego te<span class="TEX">T<span +class="E">E</span>X</span>-a, bez którego <span class="TEX">T<span +class="E">E</span>X</span> Live z całą pewnością by nie + powstał i którego stała pomoc umożliwiła doskonalenie tej dystrybucji; + </li> + <li class="itemize">Michaela Goossensa, który był współautorem pierwotnej dokumentacji; + </li> + <li class="itemize">Eitana Gurari, autora programu <span class="TEX">T<span +class="E">E</span>X</span>4ht (wykorzystanego do tworzenia niniejszej dokumentacji + w wersji HTML), który niezmordowanie pracował nad jego ulepszaniem i błyskawicznie + dostarczał poprawki; Eitan zmarł w czerwcu 2009 r. i dedykujemy tę dokumentację Jego pamięci; + </li> + <li class="itemize">Hansa Hagena, który dostosowywał Con<span class="TEX">T<span +class="E">E</span>X</span>t do potrzeb <span class="TEX">T<span +class="E">E</span>X</span> Live; + </li> + <li class="itemize">Hŕn Thế Thŕnha, Martina Schrödera i zespołu pdf<span class="TEX">T<span +class="E">E</span>X</span>-a, którzy ciągle ulepszali możliwości + <span class="TEX">T<span +class="E">E</span>X</span>-a; + </li> + <li class="itemize">Hartmuta Henkela, mającego istotny udział w rozwoju pdf<span class="TEX">T<span +class="E">E</span>X</span>-a, Lua<span class="TEX">T<span +class="E">E</span>X</span>-a i innych + programów; + + + </li> + <li class="itemize">Taco Hoekwatera, który wznowił rozwój MetaPosta i pracował nad Lua<span class="TEX">T<span +class="E">E</span>X</span>-em, jak też + pomógł w integracji Con<span class="TEX">T<span +class="E">E</span>X</span>t w <span class="TEX">T<span +class="E">E</span>X</span> Live oraz ulepszył bibliotekę Kpathsea, dodając jej + wielowątkowość; + </li> + <li class="itemize">Pawła Jackowskiego, który wykonał instalator dla Windows <span +class="ec-lmss-10">tlpm </span>i Tomka Łuczaka, twórcy + <span +class="ec-lmss-10">tlpmgui </span>(programy te były wykorzystane w poprzednich edycjach); + </li> + <li class="itemize">Akira Kakuto, który dostarczył programy dla Windows, pochodzące z dystrybucji W32TEX + (<a +href="http://w32tex.org" class="url" ><span +class="ec-lmtt-10">http://w32tex.org</span></a>), stale dostosowywane i aktualizowane dla potrzeb <span class="TEX">T<span +class="E">E</span>X</span> Live; + </li> + <li class="itemize">Jonathana Kew, który zainicjował nową ścieżkę rozwojową – Xe<span class="TEX">T<span +class="E">E</span>X</span>, i który włożył sporo + wysiłku w zintegrowanie tego programu z <span class="TEX">T<span +class="E">E</span>X</span> Live, jak również zapoczątkował prace nad + instalatorem dla Mac<span class="TEX">T<span +class="E">E</span>X</span> oraz edytorem <span class="TEX">T<span +class="E">E</span>X</span>works; + </li> + <li class="itemize">Dicka Kocha, który pielęgnuje Mac<span class="TEX">T<span +class="E">E</span>X</span>-a (<a +href="http://tug.org/mactex" class="url" ><span +class="ec-lmtt-10">http://tug.org/mactex</span></a>) w ścisłym połączeniu + z <span class="TEX">T<span +class="E">E</span>X</span> Live i bardzo sympatycznie współpracuje; + </li> + <li class="itemize">Reinharda Kotuchy, mającego istotny udział w stworzeniu nowej infrastruktury i programu + instalacyjnego dla <span class="TEX">T<span +class="E">E</span>X</span> Live 2009, uparcie dążącego do ujednolicenia działania <span class="TEX">T<span +class="E">E</span>X</span> Live + w Windows i Unix, który również opracował skrypt <span +class="ec-lmtt-10">getnonfreefonts </span>i wykonał wiele innych + prac; + </li> + <li class="itemize">Siep Kroonenberg, która również wzięła udział w stworzeniu nowej infrastruktury i programu + instalacyjnego dla <span class="TEX">T<span +class="E">E</span>X</span> Live 2009 (szczególnie dla Windows) oraz włożyła sporo pracy w + aktualizację tej dokumentacji; + </li> + <li class="itemize">Petra Olšáka, który koordynował i sprawdzał przygotowanie pakietów czeskich i słowackich; + </li> + <li class="itemize">Toshio Oshimy, który opracował przeglądarkę <span +class="ec-lmss-10">dviout </span>dla Windows; + </li> + <li class="itemize">Manuela Pégourié-Gonnarda, który pomógł w aktualizacji pakietów i pracował nad <span +class="ec-lmss-10">texdoc</span>; + </li> + <li class="itemize">Fabrice’a Popineau, który pierwszy stworzył wersje oprogramowania dla Windows; + </li> + <li class="itemize">Norberta Preininga, głównego architekta infrastruktury i programu instalacyjnego <span class="TEX">T<span +class="E">E</span>X</span> Live + 2009, który przyczynił się również do aktualizacji pakietów, a także koordynował (wraz + z Frankiem Küsterem) debianową wersję <span class="TEX">T<span +class="E">E</span>X</span> Live i przedstawił wiele sugestii ulepszeń; + </li> + <li class="itemize">Sebastiana Rahtza, który stworzył <span class="TEX">T<span +class="E">E</span>X</span> Live i kierował projektem przez wiele lat; + </li> + <li class="itemize">Phila Taylora, który skonfigurował BitTorrent (do pobierania plików z sieci) na potrzeby <span class="TEX">T<span +class="E">E</span>X</span> + Live; + </li> + <li class="itemize">Tomka Trzeciaka, który pracowicie rozwiązywał rozliczne problemy związane z Windows; + </li> + <li class="itemize">Vladimira Volovicha, który wydatnie pomógł w rozwiązywaniu problemów przenośności, + szczególnie zaś umożliwił dołączenia <span +class="ec-lmss-10">xindy</span>; + </li> + <li class="itemize">Staszka Wawrykiewicza, głównego testującego <span class="TEX">T<span +class="E">E</span>X</span> Live w różnych systemach, który ponadto + koordynował przygotowanie wszystkich polskich dodatków (fontów, programów instalacyjnych + i wielu innych); + </li> + <li class="itemize">Olafa Webera, który cierpliwie pielęgnował Web2C, od którego wszystko zależy; + </li> + <li class="itemize">Gerbena Wierda, który przygotował oryginalne oprogramowanie i wsparcie dla Mac OS X; + </li> + <li class="itemize">Grahama Williamsa, którego prace nad katalogiem pakietów bardzo pomogły w przygotowaniu + dystrybucji.</li></ul> + + +<!--l. 3153--><p class="indent" > Binaria dla różnych platform skompilowali: Ettore Aldrovandi (<span +class="ec-lmss-10">i386-solaris</span>, <span +class="ec-lmss-10">x86_64-solaris</span>), Alan Braslau +(<span +class="ec-lmss-10">amd64-kfreebsd</span>, <span +class="ec-lmss-10">i386-kfreebsd</span>), Peter Breitenlohner (<span +class="ec-lmss-10">x86_64-linux</span>), Karl Berry (<span +class="ec-lmss-10">i386-linux</span>), Ken Brown +(<span +class="ec-lmss-10">i386-cygwin</span>), Akira Kakuto (<span +class="ec-lmss-10">win32</span>), Dick Koch (<span +class="ec-lmss-10">universal-darwin</span>, <span +class="ec-lmss-10">x86_64-darwin</span>), Nikola Lečić +(<span +class="ec-lmss-10">amd64-freebsd</span>, <span +class="ec-lmss-10">i386-freebsd</span>), Mojca Miklavec (<span +class="ec-lmss-10">mipsel-linux</span>), Norbert Preining (<span +class="ec-lmss-10">alpha-linux</span>), Thomas Schmitz +(<span +class="ec-lmss-10">powerpc-linux</span>), Boris Veytsman (<span +class="ec-lmss-10">armel-linux</span>), Vladimir Volovich (<span +class="ec-lmss-10">powerpc-aix</span>, <span +class="ec-lmss-10">sparc-solaris</span>), Olaf +Weber (<span +class="ec-lmss-10">mips-irix</span>). Informacje na temat procesu budowy <span class="TEX">T<span +class="E">E</span>X</span> Live można znaleźć na stronie: +<a +href="http://tug.org/texlive/build.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/build.html</span></a>. +<!--l. 3172--><p class="indent" > Aktualizacje i tłumaczenia dokumentacji wykonali: Siep Kroonenberg i Karl Berry (angielski), Manuel +Pégourié-Gonnard (francuski), Uwe Ziegenhagen (niemiecki), Jjgod Jiang, Jinsong Zhao, Yue Wang i Helin +Gai (chiński), Marco Pallante (włoski), Nikola Lečić (serbski), Petr Sojka i Jan Busa (czeski/słowacki), Boris +Veytsman (rosyjski), Staszek Wawrykiewicz (polski). Na stronie <a +href="http://tug.org/texlive/doc.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/doc.html</span></a> będą +umieszczane ewentualne aktualizacje tej dokumentacji. +<!--l. 3185--><p class="indent" > Oczywiście, najważniejsze podziękowania należą się Donaldowi Knuthowi za stworzenie systemu <span class="TEX">T<span +class="E">E</span>X</span> +i ofiarowanie go nam wszystkim. +<!--l. 3189--><p class="noindent" > + <h3 class="sectionHead"><span class="titlemark">11. </span> <a + id="x1-7800011"></a>Historia</h3> +<!--l. 3192--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">11.1. </span> <a + id="x1-7900011.1"></a>Poprzednie wersje</h4> +<!--l. 3194--><p class="noindent" >Dystrybucja <span class="TEX">T<span +class="E">E</span>X</span> Live jest wspólnym przedsięwzięciem grup Użytkowników Systemu <span class="TEX">T<span +class="E">E</span>X</span> z Niemiec, +Holandii, Wielkiej Brytanii, Francji, Czech, Słowacji, Polski, Indii i Rosji oraz grupy międzynarodowej TUG +(<span class="TEX"><span +class="ec-lmri-10">T</span><span +class="E"><span +class="ec-lmri-10">E</span></span><span +class="ec-lmri-10">X</span></span> <span +class="ec-lmri-10">Users Group</span>). Dyskusje nad projektem rozpoczęły się pod koniec 1993 roku, kiedy holenderska Grupa +Użytkowników <span class="TEX">T<span +class="E">E</span>X</span>-a rozpoczęła prace nad swoim 4All<span class="TEX">T<span +class="E">E</span>X</span> CD dla użytkowników MS-DOS. W tym też +czasie pojawiły się nadzieje na opracowanie jednego CD dla wszystkich systemów. Projekt ten był wprawdzie +zbyt ambitny, zrodził jednak nie tylko bardzo popularny i uwieńczony dużym powodzeniem projekt +4All<span class="TEX">T<span +class="E">E</span>X</span> CD, lecz również spowodował powstanie Grupy Roboczej TUG ds. Standardu Katalogów +<span class="TEX">T<span +class="E">E</span>X</span>-owych (<span class="TEX"><span +class="ec-lmri-10">T</span><span +class="E"><span +class="ec-lmri-10">E</span></span><span +class="ec-lmri-10">X</span></span> <span +class="ec-lmri-10">Directory Structure</span>), określającego, w jaki sposób tworzyć zgodne i łatwe do +zarządzania zestawy pakietów <span class="TEX">T<span +class="E">E</span>X</span>-owych. Końcowy raport TDS został opublikowany w grudniowym +numerze <span +class="ec-lmri-10">TUGboat</span>-a, i jasnym się stało, że jednym z oczekiwanych wyników wprowadzenia tego +standardu mogłaby być modelowa struktura na płytce CD. Wydana wówczas płytka CD była +bezpośrednim rezultatem rozważań i zaleceń Grupy Roboczej ds. TDS. Jasne także było, że sukces +4All<span class="TEX">T<span +class="E">E</span>X</span> CD pokazał, że użytkownicy Unixa także wiele by zyskali, mogąc korzystać z podobnie +łatwego w instalacji/pielęgnacji i użytkowaniu systemu. Było to jednym z celów projektu <span class="TEX">T<span +class="E">E</span>X</span> +Live. +<!--l. 3219--><p class="indent" > Projekt przygotowania płytki CD, opartej na standardzie TDS i zorientowanej na systemy uniksowe, +rozpoczął się jesienią 1995 roku. Szybko zdecydowaliśmy się na wykorzystanie te<span class="TEX">T<span +class="E">E</span>X</span>-a autorstwa Thomasa +Essera, ponieważ działał na wielu platformach i został zaprojektowany z myślą o przenośności pomiędzy +różnymi systemami plików. Thomas zgodził się pomóc i prace rozpoczęły się na dobre na początku 1996 roku. +Pierwsze wydanie ukazało się w maju 1996 roku. Na początku 1997 roku Karl Berry udostępnił +nową, istotnie zmienioną wersję swojego pakietu Web2C, zawierającą prawie wszystkie funkcje +wprowadzone do te<span class="TEX">T<span +class="E">E</span>X</span>-a przez Thomasa Essera. W związku z tym zdecydowaliśmy się oprzeć +drugie wydanie CD na standardowej bibliotece Web2C, z dodaniem skryptu <span +class="ec-lmtt-10">texconfig </span>z pakietu +te<span class="TEX">T<span +class="E">E</span>X</span>. Trzecie wydanie CD było oparte na Web2C wersji 7.2, przygotowanej przez Olafa Webera. +W tym samym czasie została przygotowana nowa wersja te<span class="TEX">T<span +class="E">E</span>X</span>-a i <span class="TEX">T<span +class="E">E</span>X</span> Live udostępniał prawie +wszystkie jego nowe funkcje. Czwarta edycja była przygotowana podobnie, z użyciem nowej wersji +te<span class="TEX">T<span +class="E">E</span>X</span>-a i nowej wersji Web2C (7.3). Wtedy to też zapoczątkowano kompletną dystrybucję dla +Windows. +<!--l. 3237--><p class="indent" > Edycja piąta (marzec 2000) zawierała wiele poprawek i uzupełnień; zaktualizowano setki pakietów. +Szczegółową zawartość pakietów zapisano w plikach XML. Główną zmianą w <span class="TEX">T<span +class="E">E</span>X</span> Live 5 było usunięcie +programów, które nie miały statusu <span +class="ec-lmri-10">public domain</span>. Zawartość całej płytki powinna odpowiadać ustaleniom +Debian Free Software Guidelines (<a +href="http://www.debian.org/intro/free" class="url" ><span +class="ec-lmtt-10">http://www.debian.org/intro/free</span></a>). Dołożyliśmy wszelkich starań, aby +sprawdzić warunki licencyjne pakietów. +<!--l. 3246--><p class="indent" > Szósta edycja (lipiec 2001) zawierała aktualizacje całego materiału. Główną zmianą było wprowadzenie +nowej koncepcji programów instalacyjnych – użytkownik miał odtąd możliwość dokładniejszego wyboru +potrzebnych zestawów i pakietów. Zestawy dotyczące obsługi poszczególnych języków zostały całkowicie + + +zreorganizowane, dzięki czemu wybór jednego z nich nie tylko instalował potrzebne makra i fonty, ale też +przygotowywał odpowiedni plik <span +class="ec-lmtt-10">language.dat</span>. +<!--l. 3254--><p class="indent" > <span class="TEX">T<span +class="E">E</span>X</span> Live 7 (rok 2002) zawierał po raz pierwszy oprogramowanie dla Mac OS X i – jak zwykle – +aktualizację wszelkich programów i pakietów. Ważnym zadaniem, które wykonano, było ujednolicenie plików +źródłowych programów z dystrybucją te<span class="TEX">T<span +class="E">E</span>X</span>. W programach instalacyjnych wprowadzono możliwość wyboru +bardziej ogólnych, predefiniowanych zestawów pakietów (m.in. dla użytkowników francuskojęzycznych oraz +polskich). Nowością było także wprowadzenie procedury aktualizacji map fontowych dla Dvips i PDFTeX +podczas instalacji oraz doinstalowywania pakietów fontowych. +<!--l. 3263--><p class="indent" > W 2003 r., wraz z napływem aktualizacji i dodatkowych nowych pakietów, okazało się, że <span class="TEX">T<span +class="E">E</span>X</span> Live nie +mieści się na pojedynczym CD. Zmuszeni byliśmy podzielić <span class="TEX">T<span +class="E">E</span>X</span> Live na trzy dystrybucje, które wydano na +DVD i dwóch płytkach CD. Ponadto: + <ul class="itemize1"> + <li class="itemize">na życzenie „<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> team” zmieniono standardowe użycie programów <span +class="ec-lmss-10">latex </span>i <span +class="ec-lmss-10">pdflatex</span> – by + korzystały one z e-<span class="TEX">T<span +class="E">E</span>X</span> (patrz str. <a +href="#x1-120002.4">11<!--tex4ht:ref: text:etex --></a>); + </li> + <li class="itemize">załączono nowe fonty obwiedniowe Latin Modern, które zastępują m.in. fonty EC (zawierając + komplet znaków europejskich), szczególnie do tworzenia poprawnych plików PDF; + </li> + <li class="itemize">usunięto binaria dla platformy Alpha OSF (poprzednio usunięto także binaria dla HPUX), niestety + nie udało się znaleźć osób chętnych do wykonania kompilacji; + </li> + <li class="itemize">zmieniono instalację w systemach Windows, wprowadzając po raz pierwszy zintegrowane + środowisko pracy, oparte na edytorze XEmacs; + </li> + <li class="itemize">potrzebne programy pomocnicze dla Windows (Perl, Ghostscript, ImageMagick, Ispell) + instalowano w strukturze katalogów instalacji <span class="TEX">T<span +class="E">E</span>X</span> Live; + </li> + <li class="itemize">mapy fontowe, z których korzystają programy <span +class="ec-lmss-10">dvips</span>, <span +class="ec-lmss-10">dvipdfm </span>oraz <span +class="ec-lmss-10">pdftex</span>, generowano odtąd + w katalogu <span +class="ec-lmtt-10">texmf/fonts/map</span>; + </li> + <li class="itemize"><span class="TEX">T<span +class="E">E</span>X</span>, Metafont oraz MetaPost domyślnie pozwalały wypisywać komunikaty na ekranie i w pliku + .log, a także w operacjach <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\write</span></span></span> w ich reprezentacji 8-bitowej, zamiast tradycyjnej notacji <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">^^</span></span></span>; + w <span class="TEX">T<span +class="E">E</span>X</span> Live 7 eksperymentalnie wprowadzono zależność przekodowania wyjścia programów od + systemowej strony kodowej, potem ten pomysł zarzucono; + </li> + <li class="itemize">znacznie zmieniono niniejszą dokumentację; + </li> + <li class="itemize">wreszcie, ponieważ numery wersji kolejnych edycji mogły wprowadzać w błąd, postanowiono + identyfikować edycje <span class="TEX">T<span +class="E">E</span>X</span> Live zgodnie z rokiem wydania.</li></ul> +<!--l. 3298--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">11.2. </span> <a + id="x1-8000011.2"></a>Wydanie 2004</h4> +<!--l. 3300--><p class="noindent" >Jak w każdej kolejnej wersji, w 2004 roku uaktualniono wiele pakietów i programów. Poniżej wymieniamy +najbardziej istotne zmiany. + <ul class="itemize1"> + <li class="itemize">Gdy mieliśmy już lokalnie zainstalowane fonty, które korzystały z własnych plików <span +class="ec-lmtt-10">.map </span>i/lub + <span +class="ec-lmtt-10">.enc</span>, <span +class="ec-lmri-10">nale</span><span +class="ec-lmri-10">żało </span>przenieść te pliki w nowe miejsce w strukturze <span +class="ec-lmtt-10">texmf/</span>. + <!--l. 3308--><p class="noindent" >Pliki <span +class="ec-lmtt-10">.map </span>(map fontowych) są odtąd wyszukiwane w podkatalogach <span +class="ec-lmtt-10">fonts/map </span>(w każdym + drzewie <span +class="ec-lmtt-10">texmf</span>), zgodnie ze ścieżką określoną przez zmienną <span +class="ec-lmtt-10">TEXFONTMAPS</span>. Analogicznie, pliki + <span +class="ec-lmtt-10">.enc </span>(przekodowań fontów) są odtąd wyszukiwane w podkatalogach <span +class="ec-lmtt-10">fonts/enc</span>, zgodnie ze + ścieżką określoną przez zmienną <span +class="ec-lmtt-10">ENCFONTS</span>. O niewłaściwie umieszczonych plikach tego typu + zostaniemy ostrzeżeni podczas uruchomienia programu <span +class="ec-lmss-10">updmap</span>. Zmiany te wprowadzono w celu + uporządkowania struktury katalogów: wszystkie pliki dotyczące fontów znajdują się odtąd + w ramach jednego podkatalogu <span +class="ec-lmtt-10">fonts/</span>. + + + <!--l. 3319--><p class="noindent" >Metody radzenia sobie z sytuacjami związanymi z przejściem na nowy układ katalogów omawiał + artykuł <a +href="http://tug.org/texlive/mapenc.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/mapenc.html</span></a>. + </li> + <li class="itemize">Do <span class="TEX">T<span +class="E">E</span>X</span> Collection DVD dodano nową dystrybucję dla Windows o nazwie pro<span class="TEX">T<span +class="E">E</span>X</span>t (opartą + na MiK<span class="TEX">T<span +class="E">E</span>X</span>-u). Była ona dostępna także na odrębnym CD. Choć pro<span class="TEX">T<span +class="E">E</span>X</span>t nie bazuje na + implementacji Web2C, stosuje układ katalogów zgodny z TDS (patrz część <a +href="#x1-80002">2<!--tex4ht:ref: sec:struct-tl --></a> na str. <a +href="#x1-80002">7<!--tex4ht:ref: sec:struct-tl --></a>). + </li> + <li class="itemize">W ramach <span class="TEX">T<span +class="E">E</span>X</span> Live dotychczasowe pojedyncze drzewo katalogów <span +class="ec-lmtt-10">texmf </span>zostało rozdzielone + na trzy mniejsze: <span +class="ec-lmtt-10">texmf</span>, <span +class="ec-lmtt-10">texmf-dist </span>i <span +class="ec-lmtt-10">texmf-doc </span>(patrz część <a +href="#x1-100002.2">2.2<!--tex4ht:ref: sec:tld --></a>, str. <a +href="#x1-100002.2">8<!--tex4ht:ref: sec:tld --></a>) oraz pliki <span +class="ec-lmtt-10">README</span> + w każdym z tych katalogów). + </li> + <li class="itemize">Wszystkie + pliki makr wczytywane przez <span class="TEX">T<span +class="E">E</span>X</span>-a zostały umieszczone wyłącznie w podkalogu <span +class="ec-lmtt-10">tex </span>w ramach + <span +class="ec-lmtt-10">texmf*</span>. Tym samym usunięto zbędne katalogi <span +class="ec-lmtt-10">etex</span>, <span +class="ec-lmtt-10">pdftex</span>, <span +class="ec-lmtt-10">pdfetex </span>itp. i uproszczono metody + wyszukiwania plików. Patrz <a +href="../../../../texmf-dist/doc/generic/tds/tds.html#Extensions" ><span +class="ec-lmtt-10">texmf-dist/doc/generic/tds/tds.html#Extensions</span></a>. + </li> + <li class="itemize">Pomocnicze + skrypty wykonywalne, niezależne od platformy i zwykle uruchamiane w sposób automatyczny, + były odtąd umieszczone w nowym podkatalogu <span +class="ec-lmtt-10">scripts </span>w ramach <span +class="ec-lmtt-10">texmf*</span>. Znajdowane są + poleceniem <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">kpsewhich</span><span +class="ec-lmtt-10"> -format=texmfscripts</span></span></span>. Programy korzystające z tych skryptów mogły + wymagać modyfikacji. Patrz <a +href="../../../../texmf-dist/doc/generic/tds/tds.html#Scripts" ><span +class="ec-lmtt-10">texmf-dist/doc/generic/tds/tds.html#Scripts</span></a>. + </li> + <li class="itemize">Prawie wszystkie formaty traktują od tego wydania większość znaków jako jawnie „wyświetlalne” + (<span +class="ec-lmri-10">printable</span>), nie zaś, jak było dotychczas, konwertowane na <span class="TEX">T<span +class="E">E</span>X</span>-ową notację <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">^^</span></span></span>. Było to możliwe + dzięki domyślnemu wczytywaniu tablicy przekodowań <span +class="ec-lmtt-10">cp227.tcx</span>. Dokładniej, znaki o kodach + 32–256, HT, VT oraz FF zostały potraktowane dosłownie podczas wyświetlania komunikatów. + Wyjątkiem jest plain <span class="TEX">T<span +class="E">E</span>X</span> (tylko znaki z zakresu 32–127 są nie zmieniane), Con<span class="TEX">T<span +class="E">E</span>X</span>t (znaki z + zakresu 0–255) oraz formaty bazujące na Omedze. Podobna domyślna właściwość występowała + w <span class="TEX">T<span +class="E">E</span>X</span> Live 2003, ale w tej edycji została zaimplementowana w bardziej elegancki sposób + i z większymi możliwościami indywidualnego dostosowania (patrz <a +href="../../../../texmf/doc/web2c/web2c.html#TCX-files" ><span +class="ec-lmtt-10">texmf/doc/web2c/web2c.</span> + <span +class="ec-lmtt-10">tml#TCX-files</span></a>. (Warto wspomnieć, że wczytując Unicode, <span class="TEX">T<span +class="E">E</span>X</span> może w komunikatach błędów + pokazywać niekompletne sekwencje znaków, ponieważ został zaprojektowany „bajtowo”.) + </li> + <li class="itemize">Program <span +class="ec-lmss-10">pdfetex </span>został domyślną „maszyną” dla większości formatów (nie dotyczy to + samego Plain <span +class="ec-lmss-10">tex</span>). Domyślnie, gdy uruchamiamy polecenie <span +class="ec-lmss-10">latex</span>, <span +class="ec-lmss-10">mex </span>itp., generowane są + pliki DVI. Możliwe jest jednak wykorzystanie w <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>, Con<span class="TEX">T<span +class="E">E</span>X</span>t itp. m.in. właściwości + mikrotypograficznych zaimplementowanych w <span +class="ec-lmss-10">pdftex</span>, a także rozszerzonych cech e-<span class="TEX">T<span +class="E">E</span>X</span>-a + (<a +href="../../../../texmf-dist/doc/etex/base/" >texmf-dist/doc/etex/base/</a>). + <!--l. 3374--><p class="noindent" >Oznacza to także, co warto podkreślić, że <span +class="ec-lmri-10">zalecane </span>jest odtąd użycie pakietu <span +class="ec-lmss-10">ifpdf </span>(który działa + zarówno z plain, jak i <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>) lub analogicznych makr. Zwykłe sprawdzanie czy zdefiniowano + <span +class="ec-lmtt-10">\pdfoutput </span>bądź kilka innych poleceń pierwotnych może nie wystarczyć do rozstrzygnięcia czy + nie jest generowany plik PDF. W 2004 roku podjęliśmy wysiłek by zachować, najlepiej jak to + możliwe, kompatybilność z dotychczasowymi przyzwyczajeniami użytkowników. Brano wówczas + pod uwagę, że <span +class="ec-lmtt-10">\pdfoutput </span>może być zdefiniowany nawet wtedy, gdy generowany jest plik DVI. + </li> + <li class="itemize">pdf<span class="TEX">T<span +class="E">E</span>X</span> (<a +href="http://pdftex.org" class="url" ><span +class="ec-lmtt-10">http://pdftex.org</span></a>) zyskał wówczas wiele nowych cech: + <ul class="itemize2"> + <li class="itemize"><span +class="ec-lmtt-10">\pdfmapfile </span>i <span +class="ec-lmtt-10">\pdfmapline </span>pozwalają określić z poziomu dokumentu użyte mapy fontowe, + a także pojedyncze dodatkowe wpisy w tych mapach. + </li> + <li class="itemize">mikrotypograficzne operacje z fontami są łatwiejsze w użyciu;<br +class="newline" /><a +href="http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html" class="url" ><span +class="ec-lmtt-10">http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html</span></a> + + + </li> + <li class="itemize">wszystkie parametry pracy pdf<span class="TEX">T<span +class="E">E</span>X</span>-a, dotychczas określane w specjalnym pliku + konfiguracyjnym <span +class="ec-lmtt-10">pdftex.cfg</span>, muszą być odtąd ustawiane poleceniami wbudowanymi, jak + w pliku <span +class="ec-lmtt-10">pdftexconfig.tex</span>; plik <span +class="ec-lmtt-10">pdftex.cfg </span>nie jest już w ogóle wykorzystywany. Po + zmianie <span +class="ec-lmtt-10">pdftexconfig.tex </span>należało na nowo wygenerować pliki formatów (wciąż jednak + użytkownik miał pełną swobodę określania parametrów w redagowanym dokumencie); + </li> + <li class="itemize">więcej informacji zawarto w podręczniku pdf<span class="TEX">T<span +class="E">E</span>X</span>-a: + <a +href="../../../../texmf-dist/doc/pdftex/manual/pdftex-a.pdf" >texmf-dist/doc/pdftex/manual/pdftex-a.pdf</a>. + </li></ul> + </li> + <li class="itemize">Polecenie <span +class="ec-lmtt-10">\input </span>w programach <span +class="ec-lmss-10">tex</span>, <span +class="ec-lmss-10">mf </span>oraz <span +class="ec-lmss-10">mpost </span>akceptowało odtąd nazwy plików ograniczone + podwójnymi apostrofami, zawierające spacje i inne znaki, np.: + + + <div class="verbatim" id="verbatim-10"> + <div class="fancyvrb" id="fancyvrb23"><a + id="x1-80002r1"></a>  \input "nazwa_pliku ze spacjami"   % plain<br class="fancyvrb" /><a + id="x1-80004r2"></a>  \input{"nazwa_pliku ze spacjami"}  % latex</div> +</div> + <!--l. 3415--><p class="nopar" >Więcej informacji zawarto w podręczniku Web2C: <a +href="../../../../texmf/doc/web2c" >texmf/doc/web2c</a>. + </li> + <li class="itemize"><span +class="ec-lmtt-10">-output-directory </span>– nowa opcja programów <span +class="ec-lmss-10">tex</span>, <span +class="ec-lmss-10">mf </span>oraz <span +class="ec-lmss-10">mpost </span>– pozwalała na zapisanie + wyniku pracy w wyspecyfikowanym katalogu (np. można uruchomić program <span +class="ec-lmtt-10">tex </span>z plikiem + znajdującym się na dysku tylko do odczytu, zaś wynik zapisać na dysku pozwalającym + na to); + </li> + <li class="itemize">Rozszerzenie enc<span class="TEX">T<span +class="E">E</span>X</span> zostało szczęśliwie włączone do Web2C. Aby uaktywnić to rozszerzenie, należało + podczas generowania formatu użyć opcji <span +class="ec-lmtt-10">-enc</span>. Ogólnie mówiąc, enc<span class="TEX">T<span +class="E">E</span>X</span> obsługuje przekodowanie + wejścia i wyjścia, włączając także Unicode (UTF-8) (patrz <a +href="../../../../texmf-dist/doc/generic/enctex/" >texmf-dist/doc/generic/enctex/</a> oraz + <a +href="http://www.olsak.net/enctex.html" class="url" ><span +class="ec-lmtt-10">http://www.olsak.net/enctex.html</span></a>). + </li> + <li class="itemize">Udostępniono nowy program Aleph, który łączył cechy e-<span class="TEX">T<span +class="E">E</span>X</span> i Omega. Skromna dokumentacja jest + dostępna na <a +href="../../../../texmf-dist/doc/aleph/base" >texmf-dist/doc/aleph/base</a> oraz <a +href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph" class="url" ><span +class="ec-lmtt-10">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph</span></a>. + Format oparty na <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>-u dla programu Aleph nazwano <span +class="ec-lmss-10">lamed</span>. + </li> + <li class="itemize">Dystrybucja <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>-a została po raz pierwszy zaopatrzona w nową licencję LPPL, odtąd w pełni + zgodną i aprobowaną przez zalecenia określone w licencji Debiana. O nowościach i uaktualnieniach + można się dowiedzieć przeglądając pliki <span +class="ec-lmtt-10">ltnews </span>w <a +href="../../../../texmf-dist/doc/latex/base" >texmf-dist/doc/latex/base</a>. + </li> + <li class="itemize">Dołączono także program <span +class="ec-lmss-10">dvipng </span>konwertujący pliki DVI do formatu graficznego PNG + (<a +href="../../../../texmf/doc/man/man1/dvipng.1" >texmf/doc/man/man1/dvipng.1</a>). + </li> + <li class="itemize">W porozumieniu i z pomocą autora, Claudio Beccariego, ograniczono pakiet <span +class="ec-lmss-10">cbgreek </span>do + zestawu fontów rozsądnego rozmiaru. Usunięto sporadycznie używane fonty konturowe + i służące do prezentacji. Pełen zestaw jest oczywiście nadal dostępny z serwerów CTAN + (<a +href="http://mirror.ctan.org/tex-archive/fonts/greek/cb" class="url" ><span +class="ec-lmtt-10">http://mirror.ctan.org/tex-archive/fonts/greek/cb</span></a>). + </li> + <li class="itemize">Usunięto program <span +class="ec-lmss-10">oxdvi</span>; jego funkcje przejął <span +class="ec-lmss-10">xdvi</span>. + </li> + <li class="itemize">Programy z przedrostkiem <span +class="ec-lmss-10">ini </span>oraz <span +class="ec-lmss-10">vir </span>(np. <span +class="ec-lmss-10">initex</span>), które zwykle były dowiązaniami do programów <span +class="ec-lmss-10">tex</span>, <span +class="ec-lmss-10">mf</span> + i <span +class="ec-lmss-10">mpost</span>, nie były od tej pory dostępne – w zupełności wystarcza użycie w wierszu poleceń opcji + <span +class="ec-lmtt-10">-ini</span>. + </li> + <li class="itemize">Dystrybucja nie zawierała binariów dla platformy <span +class="ec-lmss-10">i386-openbsd </span>(głównie z powodu braku chętnych do + wykonania kompilacji). + </li> + <li class="itemize">W systemie <span +class="ec-lmss-10">sparc-solaris </span>należało ustawić zmienną systemową <span +class="ec-lmtt-10">LD_LIBRARY_PATH</span>, aby uruchomić + programy <span +class="ec-lmss-10">t1utils</span>. Binaria były kompilowane w C++, ale w tym systemie brakowało standardowego + położenia bibliotek uruchomieniowych. Wiedziano o tym już wcześniej, nie było to jednak dotychczas + udokumentowane. Z kolei dla systemu <span +class="ec-lmss-10">mips-irix </span>wymagana była obecność bibliotek MIPSpro + 7.4. + </li></ul> + + +<!--l. 3471--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">11.3. </span> <a + id="x1-8100011.3"></a>Wydanie 2005</h4> +<!--l. 3473--><p class="noindent" >Kolejna edycja przyniosła, jak zwykle, mnóstwo aktualizacji pakietów i programów. Struktura dystrybucji +ustabilizowała się, niemniej pojawiło się nieco zmian w konfiguracji: + <ul class="itemize1"> + <li class="itemize">Wprowadzono nowe skrypty <span +class="ec-lmss-10">texconfig-sys</span>, <span +class="ec-lmss-10">updmap-sys </span>i <span +class="ec-lmss-10">fmtutil-sys</span>, których zadaniem + jest modyfikowanie plików konfiguracyjnych w głównych drzewach katalogów systemu. + Dotychczasowe skrypty <span +class="ec-lmss-10">texconfig</span>, <span +class="ec-lmss-10">updmap </span>i <span +class="ec-lmss-10">fmtutil </span>modyfikują odtąd pliki użytkownika + w katalogu <span +class="ec-lmtt-10">$HOME/.texlive2005</span>. + </li> + <li class="itemize">Dodano nowe zmienne środowiskowe <span +class="ec-lmtt-10">TEXMFCONFIG </span>i <span +class="ec-lmtt-10">TEXMFSYSCONFIG</span>, które wskazują + położenie drzew katalogów z plikami konfiguracyjnymi, odpowiednio: użytkownika i systemu. + Tak więc mogło okazać się koniecznym przeniesienie własnych wersji <span +class="ec-lmtt-10">fmtutil.cnf</span> + i <span +class="ec-lmtt-10">updmap.cfg </span>w odpowiednie miejsca. Inną możliwością było przedefiniowanie <span +class="ec-lmtt-10">TEXMFCONFIG</span> + lub <span +class="ec-lmtt-10">TEXMFSYSCONFIG </span>w pliku <span +class="ec-lmtt-10">texmf.cnf</span>. W każdym z przypadków położenie tych plików + i przypisania <span +class="ec-lmtt-10">TEXMFCONFIG </span>i <span +class="ec-lmtt-10">TEXMFSYSCONFIG </span>muszą być zgodne. (Patrz część <a +href="#x1-110002.3">2.3<!--tex4ht:ref: sec:texmftrees --></a>, str. <a +href="#x1-110002.3">9<!--tex4ht:ref: sec:texmftrees --></a>.) + </li> + <li class="itemize">W wydaniu z poprzedniego roku podczas tworzenia wynikowego pliku DVI <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\pdfoutput</span></span></span> + i podobne polecenia pozostawały niezdefiniowane, mimo że używany był program <span +class="ec-lmss-10">pdfetex</span>. + Zgodnie z obietnicą, w 2005 roku zarzucono to rozwiązanie (jego celem było zapewnienie + kompatybilności). Z tego powodu użytkownik był zmuszony zmienić te dokumenty, które używały + <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\ifx\pdfoutput\undefined</span></span></span> do sprawdzania, czy plik wynikowy ma być w formacie PDF. + Zamiast tego należało zastosować pakiet <span +class="ec-lmss-10">ifpdf.sty</span>, który działa zarówno z plain <span class="TEX">T<span +class="E">E</span>X</span>-em jak + i <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>-em, albo zapożyczyć zastosowane w nim rozwiązania. + </li> + <li class="itemize">W wydaniu z 2004 roku zmieniono większość formatów tak, by na wyjściu 8-bitowe znaki były + reprezentowane przez same siebie (por. poprzednia część). Nowy plik TCX o nazwie <span +class="ec-lmtt-10">empty.tcx</span> + pozwalał w łatwy sposób uzyskać w razie potrzeby oryginalną notację (<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">^^</span></span></span>), np.: + + + <div class="verbatim" id="verbatim-11"> + <div class="fancyvrb" id="fancyvrb24"><a + id="x1-81002r1"></a>  latex --translate-file=empty.tcx twojplik.tex</div> +</div> + <!--l. 3515--><p class="nopar" > + </li> + <li class="itemize">Dołączono nowy program <span +class="ec-lmss-10">dvipdfmx</span>, służący do konwersji DVI do PDF. Program jest aktywnie + pielęgnowaną wersją programu <span +class="ec-lmss-10">dvipdfm</span>, który wciąż jest dostępny, ale nie jest już jednak + polecany. + </li> + <li class="itemize">Nowe programy <span +class="ec-lmss-10">pdfopen </span>i <span +class="ec-lmss-10">pdfclose </span>pozwalały na przeładowanie plików PDF w Adobe Acrobat Reader, + bez konieczności ponownego uruchamiania programu. (Inne przeglądarki formatu PDF, jak <span +class="ec-lmss-10">xpdf</span>, <span +class="ec-lmss-10">gv</span> + i <span +class="ec-lmss-10">gsview</span>, nigdy na tę przypadłość nie cierpiały.) + </li> + <li class="itemize">Dla spójności, zmienne <span +class="ec-lmtt-10">HOMETEXMF </span>i <span +class="ec-lmtt-10">VARTEXMF </span>zostały przemianowane odpowiednio na <span +class="ec-lmtt-10">TEXMFHOME</span> + i <span +class="ec-lmtt-10">TEXMFSYSVAR</span>. Zachowano zmienną <span +class="ec-lmtt-10">TEXMFVAR</span>, przeznaczoną domyślnie dla użytkownika. Patrz też + punkt pierwszy, powyżej. + </li></ul> +<!--l. 3534--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">11.4. </span> <a + id="x1-8200011.4"></a>Wydanie 2006–2007</h4> +<!--l. 3536--><p class="noindent" >Największą nowością edycji lat 2006 i 2007 był Xe<span class="TEX">T<span +class="E">E</span>X</span>, w postaci programów <span +class="ec-lmtt-10">xetex </span>i <span +class="ec-lmtt-10">xelatex</span>; patrz +<a +href="../../../../texmf-dist/doc/xetex/XeTeX-reference.pdf" >texmf-dist/doc/xetex/XeTeX-reference.pdf</a> lub <a +href="http://scripts.sil.org/xetex" class="url" ><span +class="ec-lmtt-10">http://scripts.sil.org/xetex</span></a>. +<!--l. 3541--><p class="indent" > W istotny sposób został zaktualizowany MetaPost, zaplanowano także jego dalszy rozwój +(<a +href="http://tug.org/metapost/articles" class="url" ><span +class="ec-lmtt-10">http://tug.org/metapost/articles</span></a>); to samo dotyczy pdf<span class="TEX">T<span +class="E">E</span>X</span>-a (<a +href="http://tug.org/applications/pdftex" class="url" ><span +class="ec-lmtt-10">http://tug.org/applications/pdftex</span></a>). +<!--l. 3545--><p class="indent" > Pliki formatów (pdf)TeX-a (<span +class="ec-lmtt-10">.fmt</span>) oraz analogiczne dla MetaPosta i MetaFonta są od tej edycji zapisywane +w podkatalogach <span +class="ec-lmtt-10">texmf/web2c</span>, choć sam ten katalog jest nadal przeszukiwany. Podkatalogi te mają nazwę +zgodną z zastosowanym podczas generowania „silnikiem”, np. <span +class="ec-lmtt-10">tex</span>, <span +class="ec-lmtt-10">pdftex </span>lub <span +class="ec-lmtt-10">xetex</span>. Zmiana ta nie powinna +być zauważalna w typowym użyciu. +<!--l. 3552--><p class="indent" > Program <span +class="ec-lmtt-10">tex </span>(plain) od tej edycji już nie analizował pierwszego wiersza rozpoczynającego się znakami <span +class="ec-lmtt-10">%&</span>, +aby ustalić jaki ma wczytać format. Pozostał zatem czysty, Knuthowy <span class="TEX">T<span +class="E">E</span>X</span>. <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> i wszystkie pozostałe +formaty nadal analizują pierwszy wiersz z <span +class="ec-lmtt-10">%&</span>. +<!--l. 3557--><p class="indent" > Oczywiście, jak zwykle, w okresie od poprzedniego wydania opracowano setki innych aktualizacji pakietów +i programów. Kolejne aktualizacje można znaleźć tradycyjnie na CTAN (<a +href="http://mirror.ctan.org" class="url" ><span +class="ec-lmtt-10">http://mirror.ctan.org</span></a>). +<!--l. 3561--><p class="indent" > Drzewo źródłowe <span class="TEX">T<span +class="E">E</span>X</span> Live jest odtąd przechowywane w Subversion. Przeglądanie umożliwia standardowy +interfejs www, a jego adres zamieszczono na stronie <a +href="http://tug.org.pl/texlive" class="url" ><span +class="ec-lmtt-10">http://tug.org.pl/texlive</span></a>. Mimo iż nie widać efektów +tej zmiany w końcowej dystrybucji, mamy nadzieję, że w nadchodzących latach będzie to stabilne +repozytorium oprogramowania dla rozwoju <span class="TEX">T<span +class="E">E</span>X</span> Live. +<!--l. 3568--><p class="indent" > W maju 2006 r. Thomas Esser ogłosił, że zaprzestaje aktualizowania dystrybucji te<span class="TEX">T<span +class="E">E</span>X</span> +(<a +href="http://tug.org/tetex" class="url" ><span +class="ec-lmtt-10">http://tug.org/tetex</span></a>). Spowodowało to znaczny wzrost zainteresowanie <span class="TEX">T<span +class="E">E</span>X</span> Live, szczególnie wśród +dystrybutorów GNU/Linuksa. (W <span class="TEX">T<span +class="E">E</span>X</span> Live zdefiniowano w przybliżeniu równoważny, nowy schemat +instalacyjny pod nazwą <span +class="ec-lmtt-10">tetex</span>.) Mamy nadzieję, że w przyszłości doprowadzi to do takich ulepszeń +w otoczeniu <span class="TEX">T<span +class="E">E</span>X</span>-owym, na których skorzystają wszyscy. +<!--l. 3576--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">11.5. </span> <a + id="x1-8300011.5"></a>Wydanie 2008</h4> +<!--l. 3578--><p class="noindent" >W 2008 roku cała infrastruktura <span class="TEX">T<span +class="E">E</span>X</span> Live została przeprojektowana i przeprogramowana. Informacja +dotycząca instalacji jest przechowywana obecnie w zwykłym pliku tekstowym <span +class="ec-lmtt-10">tlpkg/texlive.tlpdb</span>. +<!--l. 3582--><p class="indent" > Po zainstalowaniu <span class="TEX">T<span +class="E">E</span>X</span> Live wreszcie jest możliwa jego aktualizacja z internetu, podobnie jak od paru lat +umożliwia to dystrybucja MiK<span class="TEX">T<span +class="E">E</span>X</span>. Zamierzamy regularnie aktualizować pakiety, w miarę jak będą się +pojawiać na serwerach CTAN. +<!--l. 3587--><p class="indent" > W tym wydaniu pojawił się nowy „silnik”, Lua<span class="TEX">T<span +class="E">E</span>X</span> (<a +href="http://luatex.org" class="url" ><span +class="ec-lmtt-10">http://luatex.org</span></a>). 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 <span class="TEX">T<span +class="E">E</span>X</span>-owych, jak i poza nimi. + + +<!--l. 3592--><p class="indent" > Obsługa dla Windows i platform opartych na Unix została obecnie znacznie bardziej zunifikowana. +W szczególności większość skryptów w Perlu i Lua dostępna jest teraz także dla Windows (zastosowano +„wewnętrzny” Perl, dostarczany wraz z <span class="TEX">T<span +class="E">E</span>X</span> Live). +<!--l. 3597--><p class="indent" > Pojawił się nowy skrypt <span +class="ec-lmss-10">tlmgr </span>(patrz część <a +href="#x1-460005">5<!--tex4ht:ref: sec:tlmgr --></a>), który staje się głównym narzędziem do zarządzania <span class="TEX">T<span +class="E">E</span>X</span> +Live po jego instalacji. Umożliwia on aktualizację pakietów wraz z niezbędnymi wtedy czynnościami, jak +regenerowanie formatów, aktualizacja map fontowych itp. +<!--l. 3602--><p class="indent" > Wraz z pojawieniem się <span +class="ec-lmss-10">tlmgr </span>niektóre funkcje <span +class="ec-lmss-10">texconfig </span>zostały zablokowane (edycja plików +konfiguracyjnych formatów i wzorców przenoszenia). +<!--l. 3606--><p class="indent" > Program <span +class="ec-lmss-10">xindy </span>do tworzenia skorowidzów (<a +href="http://xindy.sourceforge.net/" class="url" ><span +class="ec-lmtt-10">http://xindy.sourceforge.net/</span></a>) jest obecnie dostępny dla +większości platform. +<!--l. 3610--><p class="indent" > Narzędzie <span +class="ec-lmss-10">kpsewhich </span>może obecnie raportować wszystkie wyniki przeszukiwania danego pliku (parametr +<span +class="ec-lmtt-10">–all</span>), jak również ograniczyć wyszukiwanie do jednego katalogu (parametr <span +class="ec-lmtt-10">–subdir</span>). +<!--l. 3614--><p class="indent" > Program <span +class="ec-lmss-10">dvipdfmx </span>posiada obecnie funkcję <span +class="ec-lmss-10">extractbb </span>uzyskania informacji o prostokącie ograniczającym +(<span +class="ec-lmri-10">bounding box</span>); jest to jedna z ostatnich cech przejętych od dawniej używanego programu <span +class="ec-lmss-10">dvipdfm </span>(który jest +nadal dostępny). +<!--l. 3619--><p class="indent" > Usunięto aliasy fontów <span +class="ec-lmtt-10">Times-Roman</span>, <span +class="ec-lmtt-10">Helvetica</span>, 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. +<!--l. 3624--><p class="indent" > Usunięto format <span +class="ec-lmss-10">platex</span>, by uniknąć konfliktu nazwy z używanym od wielu lat japońskim pakietem +<span +class="ec-lmss-10">platex</span>; pakiet <span +class="ec-lmss-10">polski </span>(czyli dawny <span +class="ec-lmss-10">platex</span>) jest obecnie wystarczającym sposobem na polonizację dla +<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>-a. +<!--l. 3629--><p class="indent" > Usunięto pliki <span +class="ec-lmtt-10">.pool</span>, które są obecnie wkompilowane w programy, co ułatwia ich aktualizację. +<!--l. 3632--><p class="indent" > Do tego wydania włączono także ostatnie zmiany dokonane przez Donalda Knutha (tzw. <span class="TEX"><span +class="ec-lmri-10">T</span><span +class="E"><span +class="ec-lmri-10">E</span></span><span +class="ec-lmri-10">X</span></span><span +class="ec-lmri-10"> tuneup of</span> +<span +class="ec-lmri-10">2008</span>); patrz: <a +href="http://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf" class="url" ><span +class="ec-lmtt-10">http://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf</span></a>. +<!--l. 3636--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">11.6. </span> <a + id="x1-8400011.6"></a>Wydanie 2009</h4> +<!--l. 3638--><p class="noindent" >W wydaniu 2009 najbardziej widoczną zmianą jest to, że pdf(L<span +class="ec-lmr-7">A</span> )<span class="TEX">T<span +class="E">E</span>X</span> <span +class="ec-lmri-10">automatycznie </span>dokonuje konwersji pliku +EPS do PDF, poprzez uruchomienie programu <span +class="ec-lmtt-10">epstopdf </span>(dotyczy to sytuacji, gdy użyto pliku +konfiguracyjnego <span +class="ec-lmtt-10">graphics.cfg </span><span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>-a i gdy plikiem wynikowym składu ma być PDF). Domyślne +ustawienia zapobiegają nadpisaniu wszelkich utworzonych wcześniej przez użytkownika plików PDF, ale +można także wyłączyć uruchamianie <span +class="ec-lmtt-10">epstopdf</span>, wstawiając <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\newcommand{\DoNotLoadEpstopdf}{}</span></span></span> (lub +<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\def...</span></span></span>) przed deklaracją <span +class="ec-lmtt-10">\documentclass</span>. Szczegóły można znaleźć w dokumentacji pakietu epstopdf +(<a +href="http://ctan.org/pkg/epstopdf-pkg" class="url" ><span +class="ec-lmtt-10">http://ctan.org/pkg/epstopdf-pkg</span></a>). +<!--l. 3649--><p class="indent" > Ważną zmianą jest także uruchamianie podczas kompilacji niektórych zewnętrznych programów via +<span +class="ec-lmtt-10">\write18</span>. Dotyczy to np. <span +class="ec-lmtt-10">epstopdf</span>, <span +class="ec-lmtt-10">makeindex </span>czy <span +class="ec-lmtt-10">bibtex</span>. Dokładna lista takich programów zawarta jest w +pliku <span +class="ec-lmtt-10">texmf.cnf</span>. Dla instalacji, które mogą wymagać zakazu uruchamiania takich programów „w tle” +przewidziano odpowiednią opcję w programie instalacyjnym (patrz część  <a +href="#x1-290003.2.4">3.2.4<!--tex4ht:ref: sec:options --></a>). Po instalacji można +zablokować uruchamianie w pliku <span +class="ec-lmtt-10">texmf.cnf</span>. +<!--l. 3658--><p class="indent" > Od wydania 2009 domyślnym formatem wyjściowym dla Lua(L<span +class="ec-lmr-7">A</span> )<span class="TEX">T<span +class="E">E</span>X</span> staje się PDF (wykorzystuje on +m.in. obsługę przez Lua<span class="TEX">T<span +class="E">E</span>X</span>-a fontów OpenType). Aby uzyskać plik DVI należy użyć nowych poleceń: +<span +class="ec-lmtt-10">dviluatex </span>lub <span +class="ec-lmtt-10">dvilualatex</span>. Strona domowa projektu Lua<span class="TEX">T<span +class="E">E</span>X</span>: <a +href="http://luatex.org" class="url" ><span +class="ec-lmtt-10">http://luatex.org</span></a>. +<!--l. 3663--><p class="indent" > Usunięto oryginalny silnik Omega i format Lambda (w uzgodnieniu z autorami). Pozostał zaktualizowany +Aleph i format Lamed, oraz pliki pomocnicze Omega. +<!--l. 3666--><p class="indent" > Załączono nowe wydanie fontów AMS Type 1, m.in. fonty Computer Modern. Zawierają one poprawki dokonane +w plikach metafontowych przez D. Knutha w ciągu ostatnich lat, a także poprawki hintingu. Hermann Zapf +przeprojektował także fonty Euler (patrz <a +href="http://tug.org/TUGboat/Articles/tb29-2/tb92hagen-euler.pdf" class="url" ><span +class="ec-lmtt-10">http://tug.org/TUGboat/Articles/tb29-2/tb92hagen-euler.pdf</span></a>). +Co ważne, dla wszystkich fontów nie zmieniono plików metrycznych (TFM). Strona domowa fontów: +<a +href="http://www.ams.org/tex/amsfonts.html" class="url" ><span +class="ec-lmtt-10">http://www.ams.org/tex/amsfonts.html</span></a>. +<!--l. 3674--><p class="indent" > Dla Windows i Mac<span class="TEX">T<span +class="E">E</span>X</span> dołączono nowe środowisko-edytor <span class="TEX">T<span +class="E">E</span>X</span>works. Dla innych platform patrz: +<a +href="http://tug.org/texworks" class="url" ><span +class="ec-lmtt-10">http://tug.org/texworks</span></a>. Inspirowany przez edytor TeXShop dla Mac OS X, <span class="TEX">T<span +class="E">E</span>X</span>works jest +wieloplatformowym, łatwym w użyciu środowiskiem pracy. +<!--l. 3679--><p class="indent" > Dla niektórych platform załączono nowy program graficzny Asymptote (<a +href="http://asymptote.sourceforge.net" class="url" ><span +class="ec-lmtt-10">http://asymptote.sourceforge.net</span></a>). +Korzysta on z tekstowej notacji zbliżonej do MetaPosta, ale rozszerzonej do obsługi 3D itp. +<!--l. 3683--><p class="indent" > Program <span +class="ec-lmtt-10">dvipdfm </span>został zastąpiony przez <span +class="ec-lmtt-10">dvipdfmx</span>, który działa w specjalnym trybie kompatybilnym, gdy +użyć do wywołania dawną nazwę. <span +class="ec-lmtt-10">dvipdfmx </span>wspiera CJK i zawiera wiele poprawek od ostatniej dystrybucji +<span +class="ec-lmtt-10">dvipdfm</span>. Strona domowa: <a +href="http://project.ktug.or.kr/dvipdfmx" class="url" ><span +class="ec-lmtt-10">http://project.ktug.or.kr/dvipdfmx</span></a>. +<!--l. 3689--><p class="indent" > Dodano zestawy programów dla <span +class="ec-lmss-10">cygwin </span>i <span +class="ec-lmss-10">i386-netbsd</span>, podczas gdy usunięto programy dla innych platform + + +BSD. Zapewniono nas, że użytkownicy OpenBSD i FreeBSD będą mogli pobierać pakiety <span class="TEX">T<span +class="E">E</span>X</span>-owe wraz z +aktualizacją obu systemów. Ponadto natknęliśmy się na spore trudności przy kompilacji programów, które +mogłyby działać w różnych wersjach tych systemów. +<!--l. 3696--><p class="indent" > Inne zmiany: do kompresji pakietów użyto programu <span +class="ec-lmss-10">xz</span>, stanowiącego stabilny zamiennik <span +class="ec-lmss-10">lzma</span> +(<a +href="http://tukaani.org/xz/" class="url" ><span +class="ec-lmtt-10">http://tukaani.org/xz/</span></a>); znak <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">$</span></span></span> jest obecnie dozwolony w nazwach plików, o ile nie poprzedza on nazwy +znanej zmiennej; biblioteka Kpathsea jest obecnie wielowątkowa (co wykorzystano w programie MetaPost); do +budowy wszystkich programów wykorzystano teraz Automake. +<!--l. 3703--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">11.7. </span> <a + id="x1-8500011.7"></a>Wydanie 2010</h4> +<!--l. 3706--><p class="noindent" >Od wydania 2010 generowane są pliki PDF w wersji 1.5, oferującej lepszą kompresję. Dotyczy to wszystkich +mechanizmów używanych do generowania PDF, w tym <span +class="ec-lmtt-10">dvipdfmx</span>. Powrót do wersji 1.4 jest możliwy poprzez +użycie pakietu <span +class="ec-lmss-10">pdf14 </span>lub komendy <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\pdfminorversion=4</span></span></span>. +<!--l. 3711--><p class="indent" > Obecnie pdf(L<span +class="ec-lmr-7">A</span> )<span class="TEX">T<span +class="E">E</span>X</span> <span +class="ec-lmri-10">automatycznie </span>konwertuje plik EPS (<span +class="ec-lmri-10">Encapsulated PostScript</span>) do formatu PDF, +wykorzystując pakiet <span +class="ec-lmss-10">epstopdf</span>, o ile załadowano <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>-owy plik konfiguracyjny <span +class="ec-lmtt-10">graphics.cfg </span>i wybrano +format wyjściowy PDF. Domyślne ustawienia mają na celu wykluczenie przypadkowego nadpisania +istniejących już, wygenerowanych innym sposobem plików PDF, ale można również zabronić uruchamiania +<span +class="ec-lmtt-10">epstopdf </span>wpisując przed poleceniem <span +class="ec-lmtt-10">\documentclass </span>polecenie <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\newcommand{\DoNotLoadEpstopdf}{}</span></span></span> (lub +<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">\def...</span></span></span>). Program <span +class="ec-lmtt-10">epstopdf </span>nie jest również używany w przypadku dołączenia pakietu <span +class="ec-lmss-10">pst-pdf</span>. Więcej +szczegółów znajduje się w dokumentacji pakietu epstopdf (<a +href="http://ctan.org/pkg/epstopdf-pkg" class="url" ><span +class="ec-lmtt-10">http://ctan.org/pkg/epstopdf-pkg</span></a>). +<!--l. 3723--><p class="indent" > Domyślnie włączono również wykonywanie kilku programów zewnętrznych dla <span class="TEX">T<span +class="E">E</span>X</span>-a poprzez mechanizm +<span +class="ec-lmtt-10">\write18</span>. Dotyczy to: <span +class="ec-lmtt-10">repstopdf</span>, <span +class="ec-lmtt-10">makeindex</span>, <span +class="ec-lmtt-10">kpsewhich</span>, <span +class="ec-lmtt-10">bibtex </span>i <span +class="ec-lmtt-10">bibtex8 </span>(lista jest zdefiniowana +w <span +class="ec-lmtt-10">texmf.cnf</span>). W środowiskach, w których wykonywanie zewnętrznych programów jest niepożądane, należy +tę opcję zaznaczyć podczas instalacji (patrz: część <a +href="#x1-290003.2.4">3.2.4<!--tex4ht:ref: sec:options --></a>) lub wyłączyć już po niej poprzez uruchomienie: +<span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">tlmgr</span><span +class="ec-lmtt-10"> conf</span><span +class="ec-lmtt-10"> texmf</span><span +class="ec-lmtt-10"> shell_escape</span><span +class="ec-lmtt-10"> 0</span></span></span>. +<!--l. 3731--><p class="indent" > Kolejna zmiana dotyczyła programów BibTeX i Makeindex, które (podobnie zresztą jak sam <span class="TEX">T<span +class="E">E</span>X</span>) +domyślnie nie zapisują swoich plików wynikowych do dowolnie zdefiniowanego katalogu. Umożliwia to +w ograniczonym zakresie zadziałanie polecenia <span +class="ec-lmtt-10">\write18</span>. Aby to zmienić, należy ustawić zmienną +<span +class="ec-lmtt-10">TEXMFOUTPUT </span>lub zmodyfikować <span class="obeylines-h"><span class="verb"><span +class="ec-lmtt-10">openout_any</span></span></span>. +<!--l. 3737--><p class="indent" > Podobnie jak pdf<span class="TEX">T<span +class="E">E</span>X</span>, obecnie również Xe<span class="TEX">T<span +class="E">E</span>X</span> obsługuje wyrównywanie (tzw. kernowanie) na krawędzi +wiersza, ale możliwość poszerzania pisma (<span +class="ec-lmri-10">font expansion</span>) nadal nie jest dostępna. +<!--l. 3741--><p class="indent" > Program tlmgr podczas aktualizacji zachowuje obecnie domyślnie kopię poprzedniej wersji pakietu (<span +class="ec-lmtt-10">tlmgr</span> +<span +class="ec-lmtt-10">option autobackup 1</span>), zatem aktualizacja może zostać łatwo cofnięta poprzez <span +class="ec-lmtt-10">tlmgr restore</span>. +W przypadku ograniczonej ilości miejsca na dysku, opcja ta może zostać wyłączona przez <span +class="ec-lmtt-10">tlmgr option</span> +<span +class="ec-lmtt-10">autobackup 0</span>. +<!--l. 3747--><p class="indent" > Dołączono nowe programy: p<span class="TEX">T<span +class="E">E</span>X</span> i narzędzia do składu w języku japońskim, BibTeXU dla obsługi +Unicode w BibTeX-u, chktex (<a +href="http://baruch.ev-en.org/proj/chktex" class="url" ><span +class="ec-lmtt-10">http://baruch.ev-en.org/proj/chktex</span></a>) – program do sprawdzania +dokumentów (L<span +class="ec-lmr-7">A</span> )<span class="TEX">T<span +class="E">E</span>X</span>, dvisvgm – konwerter DVI do SVG (<a +href="http://dvisvgm.sourceforge.net" class="url" ><span +class="ec-lmtt-10">http://dvisvgm.sourceforge.net</span></a>) oraz binaria +dla nowych platform sprzętowych: <span +class="ec-lmtt-10">amd64-freebsd</span>, <span +class="ec-lmtt-10">amd64-kfreebsd</span>, <span +class="ec-lmtt-10">i386-freebsd</span>, <span +class="ec-lmtt-10">i386-kfreebsd</span>, +<span +class="ec-lmtt-10">x86_64-darwin</span>, <span +class="ec-lmtt-10">x86_64-solaris</span>. +<!--l. 3756--><p class="indent" > W dokumentacji zmian poprzedniego wydanie (<span class="TEX">T<span +class="E">E</span>X</span> Live 2009) nie zdążono uwzględnić usunięcia wielu +programów uruchomieniowych dla <span class="TEX">T<span +class="E">E</span>X</span>4ht (<a +href="http://tug.org/tex4ht" class="url" ><span +class="ec-lmtt-10">http://tug.org/tex4ht</span></a>) oraz zastąpienia ich jednym programem +<span +class="ec-lmtt-10">mk4ht</span>. +<!--l. 3761--><p class="indent" > Wreszcie, z powodu niewystarczającej ilości miejsca na płycie <span class="TEX">T<span +class="E">E</span>X</span> Collection DVD, zrezygnowano +z możliwości uruchamiania <span class="TEX">T<span +class="E">E</span>X</span> Live w trybie „live”. Jednocześnie znacznie przyspieszyło to sam proces +instalacji <span class="TEX">T<span +class="E">E</span>X</span> Live z płytki DVD. +<!--l. 3765--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">11.8. </span> <a + id="x1-8600011.8"></a>Wydanie 2011</h4> +<!--l. 3767--><p class="noindent" >Edycja 2011 zawierała stosunkowo niewiele zmian w porównaniu do poprzednich wydań. +<!--l. 3770--><p class="indent" > Programy dla Mac OS X (<span +class="ec-lmtt-10">universal-darwin </span>i <span +class="ec-lmtt-10">x86_64-darwin</span>) działają od tego momentu tylko dla wersji +Leopard i późniejszych. Wersje Panther i Tiger nie będą obsługiwane. +<!--l. 3774--><p class="indent" > Dla większości platform dołączono program <span +class="ec-lmtt-10">biber</span>, służący do przetwarzania danych bibliograficznych. +Rozwój tego programu jest ściśle związany z pakietem <span +class="ec-lmtt-10">biblatex</span>, który w zupełnie nowy sposób obsługuje +bibliografie w La<span class="TEX">T<span +class="E">E</span>X</span>-u . +<!--l. 3779--><p class="indent" > Program MetaPost (<span +class="ec-lmtt-10">mpost</span>) ani nie tworzy, ani już więcej nie wykorzystuje pliku formatu <span +class="ec-lmtt-10">.mem</span>. Wymagane +pliki (np. <span +class="ec-lmtt-10">plain.mp</span>) są po prostu wczytywane przy każdym uruchomieniu. Zmiana (choć niezauważalna dla + + +przeciętnego użytkownika) związana jest z nowym, innym podejściem: MetaPost jest obecnie traktowany jako +biblioteka programów. +<!--l. 3785--><p class="indent" > Zaprogramowany w Perl program <span +class="ec-lmtt-10">updmap </span>(uprzednio stosowany tylko w Windows) został dostosowany do +wszystkich platform. Również te zmiany są niezauważalne dl użytkownika, choć znacznie przyspieszyły +działanie programu. +<!--l. 3790--><p class="indent" > <a id="news"></a> + <h4 class="subsectionHead"><span class="titlemark">11.9. </span> <a + id="x1-8700011.9"></a>Obecna edycja</h4> +<!--l. 3794--><p class="noindent" >Program <span +class="ec-lmtt-10">tlmgr </span>pozwala na aktualizacje z kilku repozytoriów w sieci. Szczegóły zawarto w pomocy (<span +class="ec-lmtt-10">tlmgr</span> +<span +class="ec-lmtt-10">help</span>), w części dotyczącej wielu repozytoriów. +<!--l. 3798--><p class="indent" > Dla parametru <span +class="ec-lmtt-10">\XeTeXdashbreakstate </span>(<span +class="ec-lmtt-10">xetex </span>i <span +class="ec-lmtt-10">xelatex</span>) ustawiono domyślnie wartość 1. Pozwala to na +łamanie wierszy po myślnikach i separatorach zakresu liczb, co było zawsze typowe dla kompilacji programami +<span class="TEX">T<span +class="E">E</span>X</span>, <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span>, Lua<span class="TEX">T<span +class="E">E</span>X</span>, itp. Chcąc zachować dotychczasowe dokładne miejsca łamania, pliki kompilowane +programem Xe<span class="TEX">T<span +class="E">E</span>X</span> wymagają zatem użycia polecenia <span +class="ec-lmtt-10">\XeTeXdashbreakstate=0</span>. +<!--l. 3806--><p class="indent" > Wynikowe pliki <span +class="ec-lmtt-10">pdftex </span>oraz <span +class="ec-lmtt-10">dvips </span>mogą obecnie przekroczyć wielkość 2GB. +<!--l. 3809--><p class="indent" > Dotychczas program <span +class="ec-lmtt-10">dvips </span>korzystał ze zbyt wielu różnych wersji standardowych 35 fontów +postscriptowych. Nie były one domyślnie włączane do pliku wynikowego, bo zakładano, że urządzenia +drukujące bądź programy (np. GhostScript) mają dostęp do odpowiednich fontów. Od tej edycji fonty ze +standardowego zestawu, dostarczone w dystrybucji <span class="TEX">T<span +class="E">E</span>X</span> Live, domyślnie są włączane do tworzonego przez +<span +class="ec-lmtt-10">dvips </span>pliku. +<!--l. 3816--><p class="indent" > W zastrzeżonym trybie pracy <span +class="ec-lmtt-10">\write18 </span>(ustawianym domyślnie) dopuszczono uruchamianie programu +<span +class="ec-lmtt-10">mpost</span>. +<!--l. 3819--><p class="indent" > Plik konfiguracyjny <span +class="ec-lmtt-10">texmf.cnf </span>znajdywany jest obecnie także w drzewie katalogów <span +class="ec-lmtt-10">../texmf-local</span>, np. +<span +class="ec-lmtt-10">/usr/local/texlive/texmf-local/web2c/texmf.cnf</span>. +<!--l. 3823--><p class="indent" > Skrypt <span +class="ec-lmtt-10">updmap </span>wczytuje <span +class="ec-lmtt-10">updmap.cfg </span>z kolejnych drzew <span class="TEX">T<span +class="E">E</span>X</span>-owych, zamiast jeden plik globalny. Zmiana +nie powinna być zauważalna, chyba że zmienimy ręcznie <span +class="ec-lmtt-10">updmap.cfg</span>. Uruchomienie <span +class="ec-lmtt-10">updmap –help </span>pokaże +szczegóły. +<!--l. 3828--><p class="indent" > Dodano binaria dla <span +class="ec-lmss-10">armel-linux </span>and <span +class="ec-lmss-10">mipsel-linux</span>. Usunięto z głównej dystrybucji binaria dla <span +class="ec-lmss-10">sparc-linux</span> +i <span +class="ec-lmss-10">i386-netbsd</span>, ale są one nadal dostępne (wraz z binariami dla kilku innych platform) na stronie: +<a +href="http://tug.org/texlive/custom-bin.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/custom-bin.html</span></a>. +<!--l. 3834--><p class="noindent" >Wszystkie wydania <span class="TEX">T<span +class="E">E</span>X</span> Live, wraz z dodatkowymi materiałami (np. okładkami płytek), są dostępne na +stronie: <a +href="ftp://tug.org/historic/systems/texlive" class="url" ><span +class="ec-lmtt-10">ftp://tug.org/historic/systems/texlive</span></a>. +<!--l. 3840--><p class="noindent" > + <h4 class="subsectionHead"><span class="titlemark">11.10. </span> <a + id="x1-8800011.10"></a> Przyszłe wersje</h4> +<!--l. 3842--><p class="noindent" ><span +class="ec-lmri-10">Niniejsza dystrybucja nie jest doskonała! </span>Planujemy kontynuować wydawanie nowych wersji i chcielibyśmy, +żeby zawierały one jeszcze więcej pomocnej dokumentacji, więcej programów użytkowych, lepsze programy +instalacyjne oraz 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 mnóstwo swojego wolnego czasu. Wiele +jeszcze zostało do zrobienia. Jeżeli możesz pomóc, nie zastanawiaj się i przyłącz się do nas. Patrz: +<a +href="http://tug.org/texlive/contribute.html" class="url" ><span +class="ec-lmtt-10">http://tug.org/texlive/contribute.html</span></a>. +<!--l. 3851--><p class="indent" > Prosimy o przesyłanie poprawek, sugestii i uzupełnień oraz deklaracji pomocy w opracowywaniu kolejnych +edycji pod adres: <a +href="mailto:tex-live@tug.org" ><span class="path"><span +class="ec-lmtt-10">tex-live@tug.org</span></span></a>. + +</body></html> + + + + diff --git a/Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.pdf b/Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.pdf Binary files differnew file mode 100644 index 00000000000..a470bb3aa68 --- /dev/null +++ b/Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.pdf diff --git a/Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.tex b/Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.tex new file mode 100644 index 00000000000..9990b17257a --- /dev/null +++ b/Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.tex @@ -0,0 +1,3862 @@ +% iso8859-2 +% $Id: texlive-pl.tex, v. 46 2012/06/04 +% 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 +% (with a little help from my friends, while my guitar gently weeps ;-) +% Public domain. +% ---- +% UWAGA dla recenzentów/tłumaczy: %%! to moje komentarze (StaW) +\documentclass{article} +\let\tldocenglish=0 % for live4ht.cfg +\let\textsl\textit +\usepackage{tex-livep} +\usepackage{polski} %% for PL +\usepackage[latin2]{inputenc} %% for PL +\exhyphenpenalty=10000 %% for PL +\def\Dash{---} +\widowpenalty=10000 +\clubpenalty=10000 +%% redefined MF logo! %% for PL +%\def\MF{\textlogo{META}\-\textlogo{FONT}} %% for PL +%\def\MP{\textlogo{META}\-\textlogo{POST}} %% *** TP *** +\def\shac{\char178} % for PL + qtmr (HTML) +\def\aac{\char225} % for PL + qtmr (HTML) +\def\iac{\char237} % for PL + qtmr (HTML) +\renewcommand{\samp}[1]{,,\texttt{#1}''} %% for PL +%% Polish style for sections +\makeatletter +\renewcommand{\@seccntformat}[1]{% + \csname the#1\endcsname.\hspace{.5em}} %% +\def\numberline#1{\hb@xt@\@tempdima{#1.\hfill}} +\makeatother +\hyphenation{tex-basic la-tex pdf-tex} +%% ----- +\begin{document} + +\title{{\huge \textit{Przewodnik po \protect\TL}\\[1ex]} + {\LARGE \textsf\TL{} 2012} +} + +\author{Redakcja: Karl Berry \\[3mm] + \url{http://tug.org/texlive/} +} + +\date{Czerwiec 2012} + +\maketitle + +\begin{multicols}{2} +\tableofcontents +%\listoftables +\end{multicols} +%-------------------------- +\section{Wstęp}\label{sec:intro} + +\subsection{\TeX\ Live i \TeX\ Collection} +Niniejsza dokumentacja opisuje oprogramowanie \TL{} -- +dystrybucję \TeX-a wraz z~programami pomocniczymi, dostępną dla +różnych wersji Unix, w~tym \acro{GNU}/Linux, \MacOSX{} i~Cygwin, +oraz Windows. + +\TL{} można ściągnąć z~sieci bądź otrzymać na płytce \DVD \TK{}, dostarczanej +swoim członkom przez Grupy Użytkowników Systemu \TeX{}. +Część \ref{sec:tl-coll-dists} omawia pokrótce zawartość tej płytki. +Zarówno \TL{}, jak i \TK{} powstały dzięki zbiorowemu wysiłkowi Grup. +W~tym dokumencie 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. Wszystko to umożliwia skład +publikacji w~wielu językach. + +Pakiety zawarte w~\TL{} są regularnie aktualizowane z serwerów \acro{CTAN} +(\textit{Comprehensive TeX Archive Network}), które gromadzą wszelkie +zasoby dotyczące systemu \TeX: \url{http://www.ctan.org}. + +Lista najważniejszych zmian dokonanych w~tej edycji \TL{} +znajduje się w~części~\ref{sec:tlcurrent}, na str.~\pageref{sec:tlcurrent}. + +Nie opisujemy tu, czym jest system \TeX{}, a~jedynie kwestię instalacji +i~konfiguracji oprogramowania \TL. +Początkujący użytkownicy mogą się zapoznać z~podstawowymi pojęciami +np. w~artykule {\it Przewodnik po systemie \TeX\/}: +\OnCD{texmf-dist/doc/generic/tex-virtual-academy-pl/cototex.html}. + +\htmlanchor{platforms} +\subsection{Obsługiwane systemy operacyjne} +\label{sec:os_support} + +\TL{} zawiera oprogramowanie dla wielu platform uniksowych, +w~tym \GNU/Linux, \MacOSX i~Cygwin. Załączone pliki źródłowe pozwalają też +na jego instalację na platformach innych systemów operacyjnych. + +Spośród systemów Windows obsługiwane są tylko XP i nowsze wersje +(choć w Windows 2000 \TL{} też w zasadzie działa). +Wprawdzie brak jest oprogramowania dedykowanego dla wersji 64-bitowych, ale +aplikacje 32-bitowe powinny na nich działać. + +W części \ref{sec:tl-coll-dists} omówiono alternatywne dystrybucje, +przeznaczone dla Windows oraz \MacOSX. + +\subsection{Podstawy instalacji \protect\TL{}} +\label{sec:basic} + +\TL{} można zainstalować z~płytki \DVD{} lub internetu +(\url{http://tug.org/texlive/acquire.html}). Program instalacyjny +jest niewielki i~pozwala pobrać z sieci wszystkie potrzebne pakiety. +Jest to wygodne, zwłaszcza gdy potrzebujemy jedynie części oprogramowania +\TL\ i~nie chcemy pobierać niepotrzebnie obrazu całej płyty instalacyjnej. + +Posiadając płytkę \TK{} \DVD{} (lub jej obraz w~pliku \code{.iso}) +możemy jedynie zaistalować \TL{} na twardym dysku, +lub przygotować przenośną instalację np. na pen drivie +(patrz część~\ref{sec:portable-tl}). +Szczegółowy opis instalacji \TL{} znajduje się w dalszych rozdziałach +tego dokumentu, tu podamy skrócony przepis: + +\begin{itemize*} + \item program instalacyjny \filename{install-tl} może działać w~kilku +trybach: tzw. ,,wizard'' (graficznym, parametr \code{-gui=wizard}) -- +domyślnym dla Windows; tekstowym (\code{-gui=text}, domyślnym dla +Unix/Linux) i~graficznym trybie ,,expert'' (parametr \code{-gui=perltk}). +Dla wygody użytkowników Windows uruchomienie +\filename{install-tl-advanced.bat} przełącza instalator w tryb ,,expert''. + %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 również można uruchamiać 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*} + +\htmlanchor{security} +\subsection{Uwagi dotyczące bezpieczeństwa} +\label{sec:security} + +Zgodnie z~naszą najlepszą wiedzą, główne programy \TeX-owe są +(i~zawsze były) nadzwyczaj odporne. Jednak mimo dokładania najwyższej +staranności, inne programy wspierające, zawarte w~\TeX\ Live, nie +zawsze osiągają ten sam poziom. Jak zawsze, należy być +ostrożnym przy uruchamianiu programów z~danymi pochodzącymi +z~niepewnych źródeł. Dla uzyskania najwyższego stopnia +bezpieczeństwa zalecamy stosowania podczas pracy nowych podfolderów. + +Konieczność zachowania staranności jest szczególnie ważna w systemie +Windows, ponieważ niezależnie od zawartości ścieżki przeszukiwania +poszukuje on programów zawsze najpierw w bieżącym folderze. To +zachowanie systemu otwiera szerokie możliwości ataku. Usunęliśmy +wiele luk, lecz niewątpliwie niektóre jeszcze pozostały, szczególnie +przy uruchamianiu programów pochodzących z~innych źródeł. Zalecamy +więc sprawdzanie bieżących folderów pod kątem obecności podejrzanych +plików, w~szczególności plików wykonywalnych (binarnych lub +skryptów). Zwykle nie powinno ich być, a~w~szczególności nie +powinny być one tworzone w~wyniku zwykłego przetwarzania dokumentów. + +I~na koniec: \TeX\ (oraz towarzyszące mu programy) mogą tworzyć +pliki przy przetwarzaniu dokumentów. Własność ta jest na wiele różnych +sposobów podatna na nadużycia. Także w~tych przypadkach, +przetwarzanie nieznanych dokumentów w~nowych podfolderach jest +najlepszym znanym sposobem zabezpieczenia. + +\subsection{Dostępna pomoc} +\label{sec:help} + +Społeczność \TeX-owa jest bardzo aktywna i~pomocna, stąd też większość +poważnych zapytań nie pozostaje 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. +(Jeśli preferujemy komercyjne wsparcie techniczne, możemy zamiast +\TL{} zakupić system u~jednego z~dostawców, których listę można znaleźć +na \url{http://tug.org/interest.html#vendors}.) + +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 wiele pytań, od najprostszych do najbardziej +zaawansowanych. Jest on załączony na \TL{} w~katalogu +\OnCD{texmf-dist/doc/generic/FAQ-en/html/index.html}, +a~także dostępny w~sieci: \url{http://www.tex.ac.uk/faq}. Proponujemy +zajrzeć najpierw tam. 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., to polecamy \TeX{} Catalogue. Jest to obszerne zestawienie +wszelkich pakietów dotyczących \TeX-a. Patrz: + %\OnCD{texmf-dist/doc/english/catalogue} lub + \url{http://mirror.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 +i~artykułów poświęconych wszelkim aspektom pracy z~systemem \TeX. + +\item [archiwa pomocy] Dwa główne fora pomocy to grupa +Usenet \url{news:comp.text.tex} oraz lista dyskusyjna +\email{texhax@tug.org}. Warto przeszukać archiwa list dyskusyjnych, +zawierające wiele pytań i odpowiedzi zbieranych przez wiele lat: +\url{http://groups.google.com/group/comp.text.tex/topics} oraz +\url{http://tug.org/mail-archives/texhax}. Nie zaszkodzi +skorzystanie z~wyszukiwarki, np. \url{http://www.google.com}. + +\item [wysyłanie pytań] Jeśli nadal nie znajdujemy rozwiązania problemu, +to możemy wysłać pytanie do \dirname{comp.text.tex}, korzystając z~Google, +czytnika wiadomości bądź pisząc list na adres \email{texhax@tug.org}. +Przedtem jednak \emph{należy} zapoznać się z~poradami dotyczącymi sposobu +zadawania pytań, zawartymi w~\acro{FAQ}: +\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}. +Warto wspomnieć stronę \LaTeX{} Community +(\url{http://www.latex-community.org/}), forum +\url{http://www.latex-community.org/forum/} oraz +\TeX\ StackExchange (\url{http://tex.stackexchange.com/}). +Polscy użytkownicy mają do dyspozycji listę dyskusyjną GUST (polskiej Grupy +Użytkowników Systemu \TeX); informacje o niej +znajdziemy na stronie \url{http://www.gust.org.pl}. + +\item [wsparcie ze strony społeczności \TL{}] Gdy chcemy zgłosić błąd +bądź sugestie i~komentarze dotyczące dystrybucji \TL{}, instalacji +lub dokumentacji, mamy do dyspozycji listę dyskusyjną +\email{tex-live@tug.org}. Jeśli kwestia dotyczy konkretnego programu +(pakietu makr itp.) z~\TL{}, to lepiej jednak skierować pytanie do osoby +opiekującej się danym programem lub na specjalistyczną listę dyskusyjną. + +\end{description} + +Druga strona medalu to pomaganie tym, którzy mają problemy. Zarówno +\dirname{comp.text.tex}, jak i~\code{texhax} (oraz lista dyskusyjna GUST) +są otwarte dla każdego, +tak więc zapraszamy do włączenia się, czytania wiadomości i~pomagania +innym w~miarę własnych możliwości. Witamy wśród użytkowników +systemu \TeX! + +%-------------------------- +\section{Struktura \protect\TeX\protect\ Live} +\label{sec:struct-tl} + +Omówimy tutaj strukturę i~zawartość dystrybucji \TL{}, a~także \TK{} -- +płytki \DVD, w~skład której wchodzi \TL. + +\subsection{\protect\TeX\protect\ Collection: \TL, pro\TeX{}t, Mac\TeX} +\label{sec:tl-coll-dists} + +\TK{} \DVD{} zawiera: + +\begin{description} + +\item [\TL] kompletny system na \acro{DVD}, pozwala na instalację na +twardym dysku lub przygotowanie przenośnej instalacji np. na pen drivie; +strona domowa projektu: \url{http://tug.org/texlive/}. + +\item [Mac\TeX] dla systemu \MacOSX; posiada własny program instalacyjny +i~dodatkowe programy dla tego systemu; strona domowa projektu: +\url{http://tug.org/mactex/}; + +\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; + strona domowa projektu: \url{http://tug.org/protext}; + +\item [CTAN] zrzut zawartości archiwów \CTAN{}; +(\url{http://www.ctan.org}). + +\item [\texttt{texmf-extra}] katalog z wybranymi pakietami dodatkowymi. + +\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 \TL} +\label{sec:tld} + +Poniżej wymieniono ważniejsze podkatalogi głównego katalogu \emph{instalacji} \TL +(na płytce \TK{} \DVD{} cała dystrybucja \TL{} została +umieszczona w katalogu \dirname{texlive}, którego struktura nieco się różni, nie zaś w~katalogu głównym; +poniżej traktujemy katalog \dirname{texlive} jako katalog główny we wszystkich +odniesieniach do \TL). + +\begin{ttdescription} +\item[bin] skompilowane programy \TeX-owe, zorganizowane w~podkatalogach + według platform systemowych; + +\item[readme-*.html] krótkie omówienie z~użytecznymi odnośnikami, +w kilku językach, w formacie \HTML{} i~zwykłym tekstowym; + +\item[source] źródła wszystkich programów, włącznie z~głównymi dystrybucjami + \Webc{} \TeX-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); + +\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 według języków. + +\item[tlpkg] skrypty, programy i~inne dane potrzebne do instalacji; + katalog zawiera także ,,prywatne'' dla \TL{} kopie oprogramowania 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 i~PDF + -- PS\_View dla Windows. +\end{ttdescription} + +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 po polsku). + Do znalezienia dokumentacji przydatne mogą być dowiązania zawarte w pliku +\OnCD{doc.html}, który znajdziemy w~głównym katalogu instalacji. Dokumentacje programów +(man, info, także w~formacie PDF) znajdują się w~katalogu +\dirname{texmf/doc}, zaś dokumentacje pakietów makr, fontów i~formatów +w~katalogu \dirname{texmf-dist/doc}. W~odszukaniu konkretnej dokumentacji +w~dowolnym z~wymienionych katalogów mogą pomóc programy \cmdname{texdoc} lub +\cmdname{texdoctk}. + +Niniejsza dokumentacja w~kilku językach znajduje się na płytce \TK{}DVD\ w~podkatalogach katalogu \dirname{texlive-doc}, +zaś po instalacji w~podkatalogach katalogu \dirname{texmf/doc/texlive}: + +\begin{itemize*} +\item{uproszczony chiński:} \OnCD{texmf/doc/texlive/texlive-zh-cn} +\item{czeski/słowacki:} \OnCD{texmf/doc/texlive/texlive-cz} +\item{angielski:} \OnCD{texmf/doc/texlive/texlive-en} +\item{francuski:} \OnCD{texmf/doc/texlive/texlive-fr} +\item{niemiecki:} \OnCD{texmf/doc/texlive/texlive-de} +\item{polski:} \OnCD{texmf/doc/texlive/texlive-pl} +\item{rosyjski:} \OnCD{texmf/doc/texlive/texlive-ru} +\item{serbski:} \OnCD{texmf/doc/texlive/texlive-sr} +\item{włoski:} \OnCD{texmf/doc/texlive/texlive-it} +\end{itemize*} + +\subsection{Predefiniowane drzewa katalogów texmf} +\label{sec:texmftrees} + +W tej części wymieniono wszystkie używane przez system, predefiniowane +zmienne specyfikujące drzewa katalogów texmf; omówiono też ich przeznaczenie. +Uruchomiając polecenie \texttt{tlmgr conf}, wyświetlimy wartości tych +zmiennych, dzięki czemu łatwo ustalimy, które katalogi w~naszej instalacji są +przypisane do konkretnych zmiennych. + +Wszystkie drzewa katalogów, włącznie z prywatnymi katalogami użytkownika, +powinny posiadać strukturę zgodną z zaleceniami \TeX\ +Directory Structure (\TDS, \url{http://tug.org/tds}), konsekwentnie wraz +z mnóstwem podkatalogów. W przeciwnym wypadku potrzebne pliki mogą nie zostać +odnalezione. W części \ref{sec:local-personal-macros} +(str.~\pageref{sec:local-personal-macros}) będzie to omówione dokładniej. + +\begin{ttdescription} +\item [TEXMFMAIN] Drzewo katalogów zawierające podstawowe dla + dystrybucji elementy systemu, jak skrypty + %(np. \verb+web2c/mktexdir+), + i~inne pliki pomocnicze oraz dokumentację programów (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ć + do przechowywania lokalnych makr, fontów itp., dostępnych dla wszystkich + 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+ (w~Windows \verb+%USERPROFILE%+). +\item [TEXMFCONFIG] Lokalne drzewo katalogów wykorzystywane przez narzędzia + \verb+texconfig+, \verb+updmap+ oraz \verb+fmtutil+ do przechowywania + danych konfiguracyjnych (domyślnie w~ramach \envname{TEXMFHOME}). +\item [TEXMFSYSCONFIG] Drzewo katalogów wykorzystywane przez narzędzia + \verb+texconfig-sys+, \verb+updmap-sys+ oraz \verb+fmtutil-sys+ + do przechowywania danych konfiguracyjnych dla całej instalacji (np. + sieciowej). +\item [TEXMFVAR] Lokalne 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 \envname{TEXMFHOME}). +\item [TEXMFCACHE] Drzewa katalogów wykorzystywane przez + \ConTeXt\ Mk\acro{IV} do przechowywania + %!!!(cached) runtime data. ??? + buforowanych danych z~przetwarzania. + %Domyślna wartość w \TL{} jest identyczna z \verb+TEXMFVAR+. +\item [TEXMFSYSVAR] Drzewo katalogów wykorzystywane przez + \verb+texconfig-sys+, \verb+updmap-sys+, \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} + +\noindent +Domyślny układ katalogów: +\begin{description} + \item[ogólnosystemowy katalog instalacji] może zawierać kilka wydań \TL{}: + \begin{ttdescription} + \item[2011] poprzednie wydanie, + \item[2012] 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-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[.texlive2011] prywatne pliki konfiguracyjne + poprzedniego wydania + \item[.texlive2012] prywatne pliki konfiguracyjne + dla bieżącego wydania: + \begin{ttdescription} + \item [texmf-var\ \ ] \envname{TEXMFVAR}, \envname{TEXMFCACHE} + \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} + +Oryginalny \TeX{}, stworzony przez prof. Knutha, 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{}, w~której dodano + pożyteczny 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 można znaleźć + w~\OnCD{texmf-dist/doc/etex/base/etex_man.pdf}. + +\item [pdf\TeX] program zawierający silnik \eTeX{} i dalsze +rozszerzenia, który umożliwia 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 obecnie 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-dist/doc/pdftex/manual/pdftex-a.pdf}, zaś przykład wykorzystania +w~pliku \OnCD{texmf-dist/doc/pdftex/manual/samplepdf/samplepdf.tex}. + +\item [Lua\TeX] docelowo sukcesor pdf\TeX-a, z~którym ma być, aczkolwiek +niecałkowicie, zgodny wstecz. +Powinien także zastąpić Aleph (patrz niżej), choć nie zakłada się +tu technicznej kompatybilności. 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} ma funkcjonalność samodzielnego +interpretera Lua, co sprawia, że jest używany 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 bezpośrednio w~systemie operacyjnym), +przy czym stosuje biblioteki obce. Patrz \url{http://tug.org/xetex}. + +\item [\OMEGA{} (Omega)] program, który pracuje wewnętrznie ze znakami +kodowanymi 16-bitowo (Unicode), pozwalając składać jednocześnie +większość tekstów spotykanych na świecie. Wspomaga 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 \DVD: + %\OnCD{texmf-dist/doc/omega/base/doc-1.8.tex} (dokumentacja niezbyt aktualna; + Sam program od dawna nie jest aktualizowany, został więc usunięty z~\TL. + Pozostawiono jego działający klon: + +\item [Aleph] łączy rozszerzenia \OMEGA\ i~\eTeX; powstał jako niezależny +projekt z~potrzeby stabilnej ,,używalności'' programu Omega, w~sytuacji, +gdy ten pozostawał wciąż w~fazie eksperymentalnej. Dostępna jest minimalna +dokumentacja: \OnCD{texmf-dist/doc/aleph/base}. + +\end{description} + +\subsection{Inne ważniejsze programy \protect\TL} + +Poniżej zestawiono kilka innych, najczęściej używanych programów, dostępnych +w~dystrybucji \TL{}: + +\begin{cmddescription} + +\item[bibtex, bibtex8] tworzenie spisów bibliograficznych; + +\item[makeindex, xindy] tworzenie posortowanych skorowidzów; + +\item[dvips] konwersja \dvi{} do \PS{}; + +\item[xdvi] przeglądarka plików \dvi{} dla X~Window; + +\item[dvilj] sterownik dla drukarek HP LaserJet; + +%\item [dv2dt, dt2dv] konwerter \dvi{} do/z tekstu ASCII; + +\item [dviconcat, dviselect] programy do manipulacji stronami w~plikach + \dvi{}; + +\item [dvipdfmx] konwersja \dvi{} do PDF, metoda alternatywna w~stosunku + do wspomnianego wyżej programu pdf\TeX{}; + %(pakiety \pkgname{ps4pdf} i~\pkgname{pdftricks} dostarczają tutaj kolejnych + %możliwości); + +\item [psselect, psnup, \ldots] narzędzia do manipulacji na plikach +postscriptowych; + +\item [pdfjam, pdfjoin, \ldots] narzędzia do manipulacji na plikach + \acro{PDF}; + +%\item [lacheck] kontrola syntaktyki plików \LaTeX-owych; + +\item [texexec, texmfstart] programy uruchamiające dla Con\TeX{}t; + +\item [tex4ht] postprocesor dla \TeX-a konwersji do HTML i XML. + +\end{cmddescription} + +%%! zostawiam tę część, choć wyleciała z wersji oryginalnej!!! 27.08.2003 +%%! zmiany: 24.09.2009 + +\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 2500). Normalna instalacja pozwala użytkownikowi skopiować +z~\DVD{} na twardy dysk jeden lub więcej zestawów, ale można też +doinstalować z niej do już zainstalowanego zestawu jedynie pojedynczy pakiet. + +Zestawy pozwalają lepiej dobrać instalowane składniki, a~także określić, +jakie języki będą obsługiwane po instalacji. Najważniejszy zestaw, wymagany +dla większości zastosowań, to ,,Essential programs and files''. Zestawy +,,Basic LaTeX packages'' i~,,Recommended fonts'' są rekomendowane dla +większości użytkowników. Pozostałe zestawy są opcjonalne. + +Oto wybrane dostępne zestawy i~krótki opis ich zawartości: + +\begin{description} +\item[Essential programs and files] podstawowe programy, pakiety makr +i~fontów systemu \TeX{}, pliki konfiguracyjne dla podstawowych sterowników; +\item[Extra BibTeX styles] dodatkowa, obszerna biblioteka stylów Bib\TeX-owych + i~bazy danych bibliograficznych (podstawowe style znajdują się w~zestawie + ,,Essential\dots''); +%\item[chemistry] pakiety makr do składu wzorów chemicznych; + \item[Context format] pakiet makr do Con\TeX{}t -- ,,dialektu'' \TeX-a + autorstwa Hansa Hagena; + %\item[documentation] dodatkowe, użyteczne dokumentacje; + %\item[etex] pliki pomocnicze dla programu e-\TeX; + \item[TeX auxiliary programs] różne programy pomocnicze; zestaw + zawiera m.in. + programy i~makra dla systemu texinfo, programy do manipulacji na plikach + DVI itp.; +\item[TeX and Outline font utilities] programy do konwersji plików + fontowych oraz testowania + i~instalacji fontów (zestaw do tworzenia fontów wirtualnych, manipulacji + plikami .gf i~.pk, programy \texttt{mft}, \texttt{fontinst} itp.); +\item[Recommended fonts] obszerna biblioteka częściej używanych fontów + w~postaci źródłowej (.mf) bądź fontów obwiedniowych oraz pliki z~definicjami + i~stylami \LaTeX-a dla tych fontów; +\item[Extra fonts] biblioteka różnych rzadziej używanych fontów; +\item[Extra formats] pliki pomocnicze do generowania dodatkowych + ,,formatów'' (tj. obszerne zestawy makr służące do wstępnego przetworzenia + i~utworzenia pliku \texttt{.fmt}); +\item[Games typesetting] pakiety do prezentacji zapisu różnych gier (szachy, + brydż itp.); +\item[Extra generic packages] obszerna biblioteka makr, trudnych do + sklasyfikowania, działających z~różnymi formatami (Plain, \LaTeX{} itp.); +\item[HTML/SGML/XML support] pakiety konwersji \LaTeX-a do XML/HTML oraz + do składu dokumentów XML/SGML; +\item[lang\dots] wsparcie poszczególnych języków; zestawy zawierają + wzorce przenoszenia wyrazów i~makra obsługi danych języków, czasem też + specyficzne fonty itp., przykładowo: + %\item[langarmenian] armeński; +%\item[langcjk] pakiety CJK (obsługa chińskiego, japońskiego i~koreańskiego); +%\item[langcroatian] chorwacki; +%\item[langcyrillic] fonty i makra do składu cyrylicą; +%\item[langczechslovak] fonty i pakiety makr dla czeskiego i~słowackiego; +%\item[langdanish] duński; +%\item[langdutch] holenderski; +%\item[langfinnish] fiński; +%\item[langfrench] francuski; +%\item[langgerman] niemiecki; +%\item[langgreek] grecki; +%\item[langhungarian] węgierski; +%\item[langindic] wsparcie dla języków indyjskich; +%\item[langitalian] włoski; +%\item[langlatin] łacina; +%\item[langmanju] język Manju; +%\item[langmongolian] mongolski; +%\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{polski}, \texttt{mwcls}, fonty i~makra dodatkowe + przydatne dla polskich użytkowników oraz dokumentacje w~języku polskim. +%\item[langportuguese] portugalski; +%\item[langspanish] hiszpański; +%\item[langswedish] szwedzki; +%\item[langtibetan] fonty i~wsparcie do składu tybetańskiego; +%\item[langukenglish] angielski (brytyjski); +%\item[langvietnamese] wietnamski; +%\item[music] makra do składu nutowego; +%\item[omega] rozszerzenie \TeX{}a autorstwa Johna Plaice'a i~Yannisa Haralambousa, działające ze znakami kodowanymi 16-bitowo; +%\item[pdftex] pliki pomocnicze dla pdf\TeX{}-a, wersji programu \TeX{} +% tworzącej pliki w~formacie PDF; +%\item[pictures] pakiety do tworzenia diagramów i~innych obiektów graficznych; +%\item[plainextra] dodatkowe biblioteki makr dla Plain \TeX; +%\item[psutils] narzędzia do manipulacji plikami \PS-owymi; +%\item[publishers] pakiety makr pochodzące od różnych wydawnictw; +%\item[t1utils] narzędzia do obsługi 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. +\end{description} +%-------------------------- +%%! koniec pozostawionej sekcji 24.09.2009 + +\begin{figure}[ht] +\begin{boxedverbatim} +Installing TeX Live 2012 from: ... +Platform: i386-linux => 'Intel x86 with GNU/Linux' +Distribution: inst (compressed) +... + Detected platform: Intel x86 with GNU/Linux + + <B> platforms: 1 out of 19 + + <S> Installation scheme (scheme-full) + 84 collections out of 85, disk space required: 3091 MB + + Customizing installation scheme: + <C> standard collections + <L> language collections + + <D> directories: + TEXDIR (the main TeX directory): + /usr/local/texlive/2012 + ... + + <O> options: + [ ] use letter size instead of A4 by default + ... + + <V> set up for portable installation + +Actions: + <I> start installation to hard disk + <H> help + <Q> quit +\end{boxedverbatim} +\caption{Główny ekran instalatora w~trybie tekstowym + (\GNU/Linux)}\label{fig:text-main} +\end{figure} + +Plik \texttt{tlpdb/texlive.tlpdb} (wykorzystywany podczas instalacji) +zawiera spis wszystkich plików w~każdym pakiecie. + +\subsection{Fonty w \protect\TL} +\label{sec:tl-fonts} + +\TL{} zawiera wiele wysokiej jakości fontów skalowanych. Patrz: +\url{http://tug.org/fonts} oraz +\OnCD{texmf-dist/doc/fonts/free-math-fonts-survey}. + +%==== + +\htmlanchor{installation} +\section{Instalacja} +\label{sec:install} + +\subsection{Start instalacji} +\label{sec:inst-start} + +Instalację \TL{} uruchamiamy z~płytki \TK{} \DVD{} (bądź po pobraniu z~sieci +pakietu instalacyjnego i~jego rozpakowaniu) skryptem \filename{install-tl} +(Unix), \filename{install-tl.bat} lub \filename{install-tl-advanced.bat} +(Windows). Dodatkowe informacje na temat różnych metod instalacji znajdziemy +na stronie \url{http://tug.org/texlive/acquire.html}. + +\begin{description} +\item [Instalacja 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} (wspólny 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}, \filename{install-tl.bat} +i~\filename{install-tl-advanced.bat}. + +\item [Instalacja z płytki \TeX{} Collection \DVD:] po zamontowaniu +płytki należy zmienić katalog bieżący na \dirname{texlive} \DVD{} +(w~Windows program instalacyjny powinien uruchomić się automatycznie). +\DVD{} otrzymamy w ramach członkostwa w~dowolnej Grupie Użytkowników +Systemu \TeX{} (kontakt w Polsce \url{http://www.gust.org.pl}). Możemy +także wypalić płytkę z dostępnego w sieci jej obrazu \ISO{} bądź zamontować +bezpośrednio plik obrazu (w większości systemów istnieje taka możliwość). Po +zainstalowaniu z \DVD\ lub obrazu \ISO{} można dokonywać aktualizacji +z~internetu (patrz \ref{sec:dvd-install-net-updates}). +\end{description} + +Bez względu na źródło stosowany jest ten sam program instalacyjny. Jedyną +widoczną różnicą przy instalacji z sieci jest pobranie zaktualizowanych +pakietów, w przeciwieństwie do \DVD\ i obrazu \ISO, które nie są +aktualizowane między corocznymi wydaniami. + +Dalsze kroki omówiono dokładniej poniżej. + + +\subsubsection{Unix} + +\noindent +Poniżej \texttt{>} oznacza znak zachęty systemu (tzw. prompt); to, +co wpisuje użytkownik, zaznaczono \Ucom{\texttt{pogrubieniem}}. +W~oknie terminala należy wykonać: +\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). Zalecane jest powiększenie okna terminala, aby +zobaczyć pełną zawartość ekranu programu instalacyjnego +(rys.~\ref{fig:text-main}). + +Do uruchomienia w~trybie graficznym (\GUI; rys.~\ref{fig:gui-main}) +wymagana jest obecność w~systemie modułu \dirname{Perl/TK} skompilowanego +ze wsparciem dla \acro{XFT} (w~systemach \GNU/Linux{} jest on z~reguły +dostępny, ale dla innych systemów niekoniecznie): +\begin{alltt} +> \Ucom{perl install-tl -gui} +\end{alltt} + +Kompletny wykaz dostępnych opcji otrzymamy uruchamiając: +\begin{alltt} +> \Ucom{perl install-tl -help} +\end{alltt} + +\textbf{Uwaga dotycząca uprawnień w Unix:} program instalacyjny +będzie respektował aktualną wartość \code{umask}. +Jeśli więc chcemy, aby instalacja była dostępna dla innych użytkowników, +musimy ustawić wartość np. \code{umask 002}. Więcej informacji na temat +\code{umask} znajdziemy w~dokumentacji posiadanego systemu operacyjnego. + +\begin{figure}[tb] +\tlpng{install-lnx-main}{\linewidth,trim=10 4 0 20,clip} +\caption{Ekran zaawansowanego programu instalacyjnego \GUI{} +(\GNU/Linux)}\label{fig:gui-main} +\end{figure} + +\textbf{Uwagi specjalne dotyczące Cygwin:} w~odróżnieniu od wielu +rzeczywistych systemów operacyjnych, których Cygwin jest jedynie emulatorem, +w~środowisku tym mogą nie być domyślnie zainstalowane niektóre programy +wymagane dla instalatora \TL. Dodatkowe informacje -- patrz +część~\ref{sec:cygwin}. + +\subsubsection{MacOSX} + +Jak wspomniano w części \ref{sec:tl-coll-dists}, dla \MacOSX{} +przygotowano odrębną dystrybucję Mac\TeX\ (\url{http://tug.org/mactex}). +W~jej wypadku należy użyć dedykowanego programu instalacyjnego, gdyż +zmienia on w~specyficzny sposób ustawienia systemu, w~szczególności pozwala +na łatwe przełączanie między różnymi dystrybucjami \TeX-a dla +\MacOSX: Mac\TeX, Fink, MacPorts. + +Mac\TeX\ jest oparty na \TL{} i główne drzewa katalogów pozostały w~nim +dokładnie takie same, dodano jedynie katalogi ze specyficznymi dla systemu +\MacOSX\ dokumentacjami i~aplikacjami. + +\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 katalogiem bieżącym, wystarczy uruchomić: +\begin{alltt} +> \Ucom{install-tl} +\end{alltt} +bądź, dla bardziej wymagającej instalacji, pozwalającej na wybór schematów, +kolekcji itp.: +\begin{alltt} +> \Ucom{install-tl-advanced} +\end{alltt} + +W linii poleceń można też podać ścieżkę do programu, np.: +\begin{alltt} +> \Ucom{D:\bs{}texlive\bs{}install-tl} +\end{alltt} +dla \TK\ \DVD, zakładając, że \dirname{D:} jest napędem \DVD +(rys.~\ref{fig:wizard-w32} pokazuje domyślny dla Windows ekran programu +instalacyjnego). + +Instalacja w~trybie tekstowym wymaga podania: +\begin{alltt} +> \Ucom{install-tl -no-gui} +\end{alltt} + +Wszystkie dostępne opcje wyświetlimy uruchamiając: +\begin{alltt} +> \Ucom{install-tl -help} +\end{alltt} + +\begin{figure}[tb] +\tlpng{wizard-w32}{\linewidth,trim=0 4 0 0,clip} +\caption{Ekran programu instalacyjnego ,,Wizard'' +(Windows)}\label{fig:wizard-w32} +\end{figure} + +\htmlanchor{cygwin} +\subsubsection{Cygwin} +\label{sec:cygwin} + +Program instalujący \TL{} obsługuje jedynie Cygwin w~wersji 1.7. +Przed instalacją w tym systemie zaleca się uruchomić program +\filename{setup.exe} i,~o~ile nie zostały one uprzednio zainstalowane, +zainstalować pakiety \filename{perl} oraz \filename{wget}. +Ponadto zalecana jest instalacja: +\begin{itemize*} +\item \filename{fontconfig} (wymagany dla \XeTeX) +\item \filename{ghostscript} (wymagany dla wielu narzędzi) +\item \filename{libXaw7} (wymagany dla \code{xdvi}) +\item \filename{ncurses} (udostępnia \code{clear} -- ,,czyste'' polecenie +stosowane przez program instalacyjny) +\end{itemize*} + +\subsubsection{Instalator w trybie tekstowym} + +Rysunek \ref{fig:text-main} przedstawia główny ekran programu +\filename{install-tl} w (domyślnym) trybie tekstowym w~systemie Unix. +W tym trybie nie używamy ani klawiszy kursora, ani myszy, +lecz wyłącznie klawiszy alfanumerycznych (uwaga: duże i~małe litery są +rozróżniane!). Wybraną opcję zatwierdzamy klawiszem Enter. +Instalator w~trybie tekstowym jest na tyle prosty, by działał na +możliwie wielu platformach, nawet wyposażonych jedynie w~podstawowe +biblioteki Perla. + +\subsubsection{Zaawansowany program instalacyjny w trybie graficznym} + +Rysunek \ref{fig:gui-main} przedstawia program instalacyjny w~trybie +graficznym, w~wersji rozszerzonej. W systemie Windows znajdziemy +tu dodatkowe przyciski dla opcji nieistotnych w systemach Unix/Linux. +Tryb ten uruchamiamy poleceniem: + +\begin{alltt} + > \Ucom{install-tl -gui=perltk} +\end{alltt} + +\subsubsection{Uproszczony program instalacyjny} + +W systemie Windows domyślnie uruchamiany jest uproszczony program +instalujący wszystkie pakiety \TL{}, który wymaga od użytkownika odpowiedzi +jedynie na kilka pytań (katalog docelowy itp.). Tryb ten, zwany +\textit{wizard} (,,czarodziej'', ,,mag'', rys.~\ref{fig:wizard-w32}), +uruchamiany jest poleceniem: + +\begin{alltt} +> \Ucom{install-tl -gui=wizard} +\end{alltt} + +\subsection{Podczas instalacji} +\label{sec:runinstall} + +Program instalacyjny jest z~założenia na tyle prosty, że szczegółowe +wyjaśnienia wydają się 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}[tb] +\begin{boxedverbatim} +Available platforms: (Dostępne platformy:) +=============================================================================== + a [ ] alpha-linux DEC Alpha with GNU/Linux + b [ ] amd64-freebsd x86_64 with FreeBSD + c [ ] amd64-kfreebsd x86_64 with GNU/FreeBSD + d [ ] armel-linux ARM with GNU/Linux + e [ ] i386-cygwin Intel x86 with Cygwin + f [ ] i386-freebsd Intel x86 with FreeBSD + g [ ] i386-kfreebsd Intel x86 with GNU/FreeBSD + h [X] i386-linux Intel x86 with GNU/Linux + i [ ] i386-solaris Intel x86 with Solaris + j [ ] mips-irix SGI IRIX + k [ ] mipsel-linux mipsel with Linux + l [ ] powerpc-aix PowerPC with AIX + m [ ] powerpc-linux PowerPC with GNU/Linux + o [ ] sparc-solaris Sparc with Solaris + p [ ] universal-darwin universal binaries for MacOSX/Darwin + s [ ] win32 Windows + t [ ] x86_64-darwin x86_64 with MacOSX/Darwin + u [ ] x86_64-linux x86_64 with GNU/Linux + v [ ] x86_64-solaris x86_64 with Solaris +\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ślnie instalowane są tylko programy dla bieżącej +platformy, ale menu to pozwala wybrać także zestawy 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 dla kilku systemów na +tej samej maszynie. + +\subsubsection{Wybór składników do instalacji} +\label{sec:components} + +\begin{figure}[tbh] +\begin{boxedverbatim} +Select scheme: (Wybór schematu do instalacji:) +=============================================================================== + a [X] full scheme (everything) + b [ ] medium scheme (small + more packages and languages) + c [ ] small scheme (basic + xetex, metapost, a few languages) + d [ ] basic scheme (plain and latex) + e [ ] minimal scheme (plain only) + f [ ] ConTeXt scheme + g [ ] GUST TeX Live scheme + h [ ] teTeX scheme (more than medium, but nowhere near full) + i [ ] XML scheme + j [ ] custom selection of collections +\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 do instalacji: podstawowej (\optname{basic}), +typowej (\optname{medium}) i~pełnej (\optname{full}; jest ona +domyślna), pozostałe przygotowano z~myślą o~wybranych grupach +użytkowników (np.~GUST) lub zastosowaniach (np.~XML lub ConTeXt). + +\begin{figure}[tb] +\begin{center} +\tlpng{stdcoll}{.7\linewidth,trim=0 4 0 0,clip} +\caption{Menu Collections (Kolekcje)}\label{fig:collections-gui} +\end{center} +\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 o~nazwach: ,,Kolekcje +standardowe'' i~,,Kolekcje językowe'' (rys.~\ref{fig:collections-gui}). +Kolekcje stanowią niższy poziom niż schematy, a~same składają się z +,,pakietów''. Dopiero pakiety zawierają właściwe pliki makr, fontów itp. +Jeśli chcemy dodać lub usunąć pakiet, to po instalacji właściwej użyjemy +programu \TeX\ Live Manager (\prog{tlmgr}, patrz część~\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 (|%SystemDrive%\texlive\2012|) +i~w~Unix (\dirname{/usr/local/texlive/2012}). + +Głównym powodem, dla którego chcielibyśmy ewentualnie zmienić domyślne +położenie \dirname{TEXDIR}, +może być brak uprawnień systemowych. Aby zainstalować \TL{}, nie musimy być +administratorem systemu, musimy jednak posiadać uprawnienia do zapisu +w~docelowym katalogu. Rozsądną alternatywą może być wtedy instalacja +w~katalogu domowym, szczególnie gdy będziemy jej jedynym użytkownikiem. +Stosujemy tu zapis ,,|~|'' do zaznaczenia katalogu domowego użytkownika, np. +|~/texlive/2012|. Zalecamy użycie katalogu z~nazwą odzwierciedlającą +rok wydania, co pozwoli na zainstalowanie 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 ścieżki +katalogów określone przez zmienne \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. Po raz kolejny +podkreślmy, że tak jak inne drzewa katalogów, \envname{TEXMFHOME} musi +mieć strukturę zgodną z \TDS. + +Katalog określany przez zmienną \dirname{TEXMFVAR} przechowuje +dane konfiguracyjne specyficzne dla każdego użytkownika. Katalog +określany przez zmienną \dirname{TEXMFCACHE} przechowuje dane buforowane +(\textit{cached}) \ConTeXt\ Mk\acro{IV} (patrz część~\ref{sec:context-mkiv}, +na str.~\pageref{sec:context-mkiv}). + +\subsubsection{Opcje} +\label{sec:options} + +\begin{figure}[tbh] +\begin{boxedverbatim} +Options setup: +=============================================================================== + <P> use letter size instead of A4 by default: [ ] + <E> execution of restricted list of programs: [X] + <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: + <Y> after installation, get package updates from CTAN: [X] +\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 je wymienić: + +\begin{description} +\item[use letter size instead of A4 by default] (użyj domyślnie formatu +papieru letter zamiast A4): pozwala określić domyślny format papieru +dla wielu programów. Oczywiście format papieru można (nawet: należy) +specyfikować dla każdego dokumentu w miarę potrzeby. + +\item[execution of restricted list of programs] (zezwalaj na uruchomienie + niektórych programów): od \TL\ 2010 wykonanie niektórych przydatnych + programów pomocniczych, uruchamianych jako podprocesy (w~,,tle''), zostało + zastrzeżone dla ich niewielkiej listy, zamieszczonej w~pliku + \filename{texmf.cnf}. Szczegóły znajdziesz w~części ,,Wydanie + 2010'' (\ref{sec:2010news}). + +\item[create format files] (generuj pliki formatów): +chociaż zbędne formaty zajmują miejsce na dysku, zaleca się +pozostawić tę opcję włączoną; jeśli tego nie zrobimy, formaty będą +generowane automatycznie (w~razie potrzeby) w~prywatnych katalogach +\dirname{TEXMFVAR} użytkowników, nie będą jednak odświeżane, gdy w~instalacji +zostaną zaktualizowane np. same programy bądź wzorce przenoszenia; wskutek +tego pliki formatów mogą utracić zgodność ze środowiskiem, w~którym są +używane. + +\item[install font/macro \ldots\ tree] (instaluj pliki źródłowe i/lub + dokumentacji dla fontów bądź makr): wprawdzie wyłączenie tych opcji + pozwala zaoszczędzić miejsce na dysku, ale nie jest zalecane. + +\item[create symlinks in standard directories] (utwórz dowiązania + w~standardowych katalogach, dotyczy tylko Unix): opcja ta pozwala + uniknąć ustawiania zmiennych środowiska po instalacji (\envname{PATH}, + \envname{MANPATH} i~\envname{INFOPATH}), ale jej 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. + Wymaga ona ponadto uprawnień do zapisu w docelowych katalogach. + +\item[after installation \ldots\ \CTAN] (po instalacji użyj CTAN, aby pobrać + aktualizacje): gdy instalujemy z~\DVD, opcja ta jest domyślnie włączona, + co pozwala dokonać aktualizacji zainstalowanych pakietów z~sieci (z~kopii + CTAN). Jedyny powód, dla którego moglibyśmy wyłączyć tę opcję, to sytuacja, + gdy instalujemy tylko część pakietów i~zamierzamy potem doinstalować z~\DVD\ + inne. Tak czy inaczej, repozytorium pakietów do instalacji bądź + aktualizacji może być w~każdej chwili zmienione w~linii poleceń, lub + po wyborze odpowiedniego menu programu \cmdname{tlmgr} w~trybie graficznym. + Patrz część~\ref{sec:location} i~część~\ref{sec:dvd-install-net-updates}. +\end{description} + +Po wykonaniu wszystkich potrzebnych ustawień można rozpocząć instalację +(klawisz ,,I''). Po instalacji zaleca się zajrzeć do części +\ref{sec:postinstall}, bo być może będą jeszcze potrzebne dodatkowe kroki. + +%\htmlanchor{runfromdvd} +%\subsubsection{Uruchamianie bezpośrednio z DVD{} (tylko w trybie tekstowym)} +%\label{sec:fromdvd} +% +%Aby uruchomić programy bezpośrednio z~płytki \DVD{}, należy wybrać +%opcję ,,|V|'', co zmienia menu na przedstawione na +%rys.~\ref{fig:main-fromdvd}. +%\begin{figure}[tbh] +%\begin{boxedverbatim} +%======================> TeX Live installation procedure <===================== +%... +% <D> directories: +% TEXDIRW (Writable root): +% !! default location: /usr/local/texlive/2009 +% !! 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/2009/texmf-var +% TEXMFSYSCONFIG (directory for local config): +% /usr/local/texlive/2009/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} +% +%Zwróćmy uwagę na następujące zmiany w menu: zniknęły wszystkie opcje dotyczące +%wyboru pakietów, sekcja dotycząca katalogów pokazuje teraz \dirname{TEXDIRW} +%-- katalog posiadający prawa do zapisu. Pozwoli to uruchamiać dowolny program +%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}. +% +%Instalator \GUI nie posiada opcji ,,V'', dlatego +%użytkownicy Windows mogą uruchomić program jedynie +%z~linii poleceń, jak opisano to w~części~\ref{sec:cmdline}. +% +%W~rozdziale \ref{sec:portable-tl} opisano jeszcze inny, przenośny sposób +%uruchamiania \TL, który nie wymaga zmian w~konfiguracji systemu +%(a~wręcz nie pozwala na nie). + +\subsection{Parametry instalacji z linii poleceń} +\label{sec:cmdline} + +Uruchom +\begin{alltt} +> \Ucom{install-tl -help} +\end{alltt} +aby wyświetlić wszystkie dostępne parametry. + % Either |-| or |--| can be used to introduce option names. + Oto najczęściej używane: + +\begin{ttdescription} +\item[-gui] użyj (jeśli to możliwe) programu w~wersji graficznej (\GUI); + wymagane jest posiadanie modułu Perl/Tk + (\url{http://tug.org/texlive/distro.html#perltk}) skompilowanego ze +wsparciem dla \acro{XFT}; +gdy jest on niedostępny, program instalacyjny uruchomiony zostanie +w trybie tekstowym; +\item[-no-gui] wymusza tryb tekstowy, np. w~Windows. +\item[-lang {\sl ll}] pozwala wybrać język komunikatów, + \textsl{ll} oznacza tu dwuliterowy kod języka; listę dostępnych + języków wyświetli \code{install-tl --help}; + %angielski (\texttt{en}, domyślny), + % chiński tradycyjny (\texttt{zh-tw}), + % chiński uproszczony (\texttt{zh-cn}), + % czeski (\texttt{cz}, + % francuski (\texttt{fr}), + % holenderski (\texttt{nl}), + % japoński (\texttt{ja}), + % niemiecki (\texttt{de}), + % polski (\texttt{pl}), + % rosyjski (\texttt{ru}), + % serbski (\texttt{sr}), + % słowacki (\texttt{sk}), + % słoweński (\texttt{sl}), + % włoski (\texttt{it}) i~wietnamski (\texttt{vi}); + program samoczynnie wykrywa język systemu, ale jeśli jest to niemożliwe, +komunikaty i menu będą wyświetlane w języku angielskim; + +\htmlanchor{opt-in-place} +\item[-in-place] jeśli posiadamy kopię repozytorium \TL{} uzyskaną via + rsync, svn itp. (patrz \url{http://tug.org/texlive/acquire-mirror.html}), + opcja ta pozwala na wykorzystanie jako instalacji owej kopii i jedynie + wykona kroki poinstalacyjne (konfigurację). \textbf{Uwaga:} plik + \filename{tlpkg/texlive.tlpdb} może zostać nadpisany, a więc warto go + uprzednio skopiować w bezpieczne miejsce. Ponadto usuwanie zbędnych pakietów + należy wykonać wtedy ręcznie, słowem, użycie tej opcji zaleca się jedynie + zaawansowanym użytkownikom. Opcja ta może być włączona/wyłączona w programie + instalacyjnym. + +\item[-portable] instalacja do użycia przenośnego, np. na pen drivie; + opcja ta może być użyta zarówno w trybie tekstowym (poleceniem \code{V}), + jak i przez wyb˘r odpowiedniego przycisku programu instalacyjnego w trybie +GUI (patrz część ~\ref{sec:portable-tl}). + +\item[-profile {\sl plik}] wczytuje \var{plik} profilu instalacji + i~przebiega ona bez interakcji ze strony użytkownika; program + instalacyjny zapisuje plik \filename{texlive.profile} w~katalogu + \dirname{tlpkg} naszej instalacji, co pozwala wykorzystać go dla + powielenia w trybie wsadowym wszystkich wyborów i~ustawień w~kolejnych + instalacjach; + +\item [-repository {\sl url-lub-ścieżka}] pozwala określić inne niż + domyślne źródło instalacji (patrz poniżej). +\end{ttdescription} + +\subsubsection{Parametr \optname{-repository}} +\label{sec:location} + +Domyślnym repozytorium pakietów dla \TL{} jest kopia (\textit{mirror}) CTAN, +znajdywana automatycznie poprzez sewis \url{http://mirror.ctan.org}. + +Parametrowi \optname{-repository} można przypisać adres w sieci +(rozpoczynający się od \texttt{ftp:}, \texttt{http:} lub \texttt{file:/}) lub +pełną ścieżkę do kopii pakietów na dysku (np. pobranej za pomocą programu +\filename{wget} lub \filename{rsync}). Jeśli podany argument wskazuje na +lokalny dysk (ścieżkę bądź adres \texttt{file:/}), wybrana zostanie +instalacja ze skompresowanych plików \filename{tar.xz}, zawartych +w~podkatalogu \dirname{archive}. (Podając adres \texttt{http:}\ lub +\texttt{ftp:}\ końcowy znak `\texttt{/}' lub komponent `\texttt{/tlpkg}' są +ignorowane.) + +Przykładowo, można wybrać konkretną kopię (zwierciadło) \CTAN\ z +\url{http://ctan.example.org/tex-archive/systems/texlive/tlnet/} podstawiając +prawdziwą nazwę hosta i jego konkretną ścieżkę do korzenia \CTAN\ zamiast +|ctan.example.org/tex-archive|. Lista zwierciadeł \CTAN\ jest dostępna na +stronie \url{http://ctan.org/mirrors}. + +\subsection{Czynności poinstalacyjne} +\label{sec:postinstall} + + % %Część ta nie dotyczy systemu Windows, dla którego program instalacyjny + %przeprowadza całą konfigurację, włącznie z~ustawieniami menu systemowego + %i~tworzeniem ikon na pulpicie. Poniższe uwagi mogą być przydatne dla + %użytkowników innych systemów. + % + %\subsubsection{Gdy zastosujemy dowiązania symboliczne} + % + +\subsubsection{Zmienne środowiska dla Unix} +\label{sec:env} + +Użycie opisanej w~części~\ref{sec:options} opcji tworzenia dowiązań +symbolicznych w~standardowych katalogach nie wymaga zmian w zmiennych +środowiska systemowego. Niemniej jednak w systemach Unix +po instalacji należy do zmiennej \envname{PATH} dodać ścieżkę do +programów \TL. (W Windows program instalacyjny czyni to za nas.) + +Każda z~obsługiwanych platform ma własny podkatalog +w~ramach \dirname{TEXDIR/bin}. Listę platform i odpowiadających im katalogów +przedstawiono na rys.~\ref{fig:bin-text}. + +Również korzystanie z~systemowych przeglądarek dokumentacji \prog{man} +i~\prog{info} staje się możliwe dopiero +po dodaniu odpowiednich katalogów do ich ścieżek przeszukiwania. +Strony \prog{man} mogą być także znajdywane automatycznie po dodaniu +ścieżki ich położenia do \envname{MANPATH}. + +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/2012/bin/i386-linux:$PATH; export PATH +MANPATH=/usr/local/texlive/2012/texmf/doc/man:$MANPATH; export MANPATH +INFOPATH=/usr/local/texlive/2012/texmf/doc/info:$INFOPATH; export INFOPATH +\end{sverbatim} + +W~wypadku csh lub tcsh należy zmodyfikować plik \filename{$HOME/.cshrc}, np.: + +\begin{sverbatim} +setenv PATH /usr/local/texlive/2012/bin/i386-linux:$PATH +setenv MANPATH /usr/local/texlive/2012/texmf/doc/man:$MANPATH +setenv INFOPATH /usr/local/texlive/2012/texmf/doc/info:$INFOPATH +\end{sverbatim} + +Jeśli są już jakieś ustawienia zawarte w prywatnych plikach konfiguracyjnych, +wówczas oczywiście katalogi \TL\ powinny być tam odpowiednio wkomponowane. + +\subsubsection{Zmienne środowiska: konfiguracja globalna} +\label{sec:envglobal} + +Jeśli zmiany mają być dokonane globalnie, lub jeśli mają być dokonane dla +nowego użytkownika systemu, wówczas należy dokonać tego na własną rękę -- +jest zbyt wiele możliwości dla różnych systemów dotyczących miejsca i sposobu +konfiguracji. + +Nasze dwie rady są następujące: 1)~można sprawdzić plik +\filename{/etc/manpath.config} i,~jeśli jest obecny, dodać w nim wiersze +\begin{sverbatim} +MANPATH_MAP /usr/local/texlive/2012/bin/i386-linux \ + /usr/local/texlive/2012/texmf/doc/man +\end{sverbatim} + 2)~można sprawdzić plik \filename{/etc/environment}, w którym może być +zdefiniowana ścieżka wyszukiwania i~inne domyślne zmienne środowiska. + +W każdym katalogu w plikami wykonywalnymi systemów uniksowych możemy utworzyć +symboliczne dowiązanie o nazwie \code{man} do katalogu +\dirname{texmf/doc/man}. Niektóre programy \code{man}, np. standardowy +program \code{man} w systemie \MacOSX, automatycznie znajdą to dowiązanie, +likwidując potrzebę jakiegokolwiek ustawiania dla stron manuala. + +\subsubsection{Aktualizacje z internetu po instalacji z \DVD} +\label{sec:dvd-install-net-updates} + +Po instalacji z \DVD\ i \textbf{po modyfikacji} ścieżki wyszukiwania +programów (jak opisano to powyżej), możemy pobrać z internetu aktualizacje +pakietów: + +\begin{alltt} +> \Ucom{tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet} +\end{alltt} + +Wówczas pakiety będą aktualizowane z najbliższej, automatycznie +znalezionej kopii archiwów CTAN (co domyślnie włączono podczas instalacji). +Jeśli wystąpią problemy z automatycznym wyborem archiwum, należy podać +konkretny adres (listę adresów znajdziemy na \url{http://ctan.org/mirrors}) +wraz z pełną ścieżką do podkatalogu \dirname{tlnet}. + +\htmlanchor{xetexfontconfig} % keep historical anchor working +\htmlanchor{sysfontconfig} +\subsubsection{Konfiguracja fontów dla \XeTeX\ i~Lua\TeX} +\label{sec:font-conf-sys} + +\XeTeX\ i~Lua\TeX\ pozwalają użyć każdy font zainstalowany w~systemie, +nie tylko fonty znajdujące się w~katalogach \TeX-owych. Korzystają tu ze +zbliżonych, ale jednak różnych metod. + +W systemach Windows fonty dostarczone z~\TL\ są automatycznie dostępne +dla programu \XeTeX{}. +Gdy w systemie uniksowym zainstalowano \filename{xetex}, należy +skonfigurować system tak, aby program ten mógł znaleźć fonty dostarczone +w~\TL. Aby to ułatwić, podczas instalacji pakietu tworzony jest +plik konfiguracyjny fontów: +\filename{TEXMFSYSVAR/fonts/conf/texlive-fontconfig.conf}. + +Aby udostępnić fonty \TL{} dla innych aplikacji systemu +(zakładając, że mamy odpowiednie uprawnienia) należy wykonać +następujące czynności: +\begin{enumerate*} +\item skopiować \filename{texlive-fontconfig.conf} do +\dirname{/etc/fonts/conf.d/09-texlive.conf}; +\item uruchomić \Ucom{fc-cache -fsv}. +\end{enumerate*} + +Jeśli nie mamy odpowiednich uprawnień i chcemy podczas uruchamiania \XeTeX-a +korzystać jedynie z~fontów dostępnych w~\TL, należy: +\begin{enumerate*} +\item skopiować plik \filename{texlive-fontconfig.conf} do + \filename{~/.fonts.conf}, gdzie \filename{~} oznacza nasz katalog domowy. +\item uruchomić \Ucom{fc-cache -fv}. +\end{enumerate*} + +Uruchomienie programu \code{fc-list} pozwala wyświetlić nazwy fontów +systemowych. \code{fc-list : family style file spacing} pokaże więcej +interesujących informacji. + +%\subsubsection{Gdy uruchamiamy programy z~DVD} +% +%Programy \TL{} wyszukują potrzebne dane w~różnych drzewach katalogów, +%korzystając z~pliku \filename{texmf.cnf}. Plik ten poszukiwany 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 +%zdefiniowanie w~środowisku zmiennej \envname{TEXMFCNF}, która wskaże +%położenie \filename{texmf.cnf}. Nadal jest potrzebna modyfikacja zmiennej +%\envname{PATH}, jak 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/2009/texmf-var/web2c}) +%potrzebujemy deklaracji: +%\begin{sverbatim} +%TEXMFCNF=/usr/local/texlive/2009/texmf-var/web2c; export TEXMFCNF +%\end{sverbatim} +%lub, dla [t]csh: +%\begin{sverbatim} +%setenv TEXMFCNF /usr/local/texlive/2009/texmf-var/web2c +%\end{sverbatim} +% +%Opcja ta jest najbardziej przydatna, gdy chcemy uruchamiać programy \TL{} +%we własnym systemie, ale brak nam wystarczającego miejsca na dysku. +%W pełni przenośny sposób korzystania z~\TL{}, np. z pen drive USB, +%opisano w części~~\ref{sec:portable-tl}. + +\subsubsection{\ConTeXt{} Mark IV} +\label{sec:context-mkiv} + +Zarówno tzw. ,,stary'' \ConTeXt{} (Mark \acro{II}), jak i~nowy +\ConTeXt{} (Mark \acro{IV}, oparty na Lua\TeX) powinny działać po instalacji +\TL bez problemów, o ile do aktualizacji będziemy używać wyłącznie programu +\verb+tlmgr+. + +Ponieważ \ConTeXt{} Mk\acro{IV} nie stosuje biblioteki kpathsea do +wyszukiwania plików, po zainstalowaniu ręcznie nowych plików (bez użycia +\verb+tlmgr+) wymagane jest uruchomienie: +\begin{sverbatim} +context --generate +\end{sverbatim} +do odświeżenia danych buforowych \ConTeXt. +Wygenerowane dane buforowe zostaną zapisane w~katalogach wskazywanych przez +zmienną \code{TEXMFCACHE} (domyślna wartość w \TL\ tej zmiennej to +\verb+TEXMSYSVAR;TEXMFVAR+). + +\ConTeXt\ Mk\acro{IV} przeszuka wszystkie ścieżki wymienione w +\verb+TEXMFCACHE+ i zapisze dane w pierwszej ścieżce, która jest dostępna +do zapisu. Gdy dane buforowe są zduplikowane, podczas ich odczytywania +zostaną wykorzystane ostatnio znalezione. + +Więcej informacji znajdziemy na stronach: +\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}, katalog \dirname{TEXMFLOCAL} +(domyślnie \dirname{/usr/local/texlive/texmf-local} lub +\verb|%SystemDrive%\texlive\texmf-local| w~Windows) 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 te katalogi powinny być zachowywane przy +instalacji nowszych wersji \TL{}, a~ich zawartość ma być automatycznie +dostępna w~kolejnych wydaniach. Zalecamy zatem, by nie +przedefiniowywać \dirname{TEXMFLOCAL}, co pozwoli uniknąć ręcznego +konfigurowania 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~graficznym trybie programu TeX Live Manager (\prog{tlmgr}). + +Każda z tych zmiennych ma domyślnie przypisany pojedynczy katalog, ale +nie musi być to regułą. Jeśli testujemy różne wersje pakietów, możemy +do własnych celów zakładać kolejne drzewa katalogów i przełączać kolejność +ich przeszukiwania. Wystarczy zadeklarować zmienną \dirname{TEXMFHOME} +dla listy katalogów, które oddzielamy przecinkami i~umieszczamy w~klamrach: + +\begin{verbatim} + TEXMFHOME = {/my/dir1,/mydir2,/a/third/dir} +\end{verbatim} + +W części \ref{sec:brace-expansion} opisano dokładniej analizę listy +katalogów umieszczonych w klamrach. + +\subsubsection{Integracja fontów z innych źródeł} + +Jest to, niestety, bardzo skomplikowane zagadnienie, wymagające sporej wiedzy +użytkownika. Warto najpierw się dowiedzieć, jakie fonty mamy dostępne +bezpłatnie (patrz część~\ref{sec:tl-fonts}). + +Alternatywą jest tu użycie programu \XeTeX{} lub Lua\TeX\ (patrz +część~\ref{sec:tex-extensions}), które korzystają z fontów systemowych +bez potrzeby instalowania ich dla programów \TeX-owych. + +Procedury instalacji i integracji fontów + % for our best effort at wielkim staraniem ?? + opisano dokładnie np. +w:~\url{http://tug.org/fonts/fontinstall.html}. + +\subsection{Testowanie instalacji} +\label{sec:test-install} + +Po zainstalowaniu \TL{} warto sprawdzić, czy programy działają +poprawnie. Opiszemy tu podstawowe procedury testujące funkcjonowanie +systemu w~systemach Unix. W~\MacOSX{} i~Windows najczęściej użyjemy +środowiska graficznego (\GUI), reguły jednak będą podobne. + +\begin{enumerate} +\item Sprawdzamy najpierw, czy uruchamia się program \cmdname{tex}: + +\begin{alltt} +> \Ucom{tex -{}-version} +TeX 3.1415926 (TeX Live ...) +kpathsea version 6.0.1 +Copyright ... D.E. Knuth. +... +\end{alltt} +Jeśli uruchomienie kończy się komunikatem \emph{command not found} +(\emph{nie znaleziono polecenia}), oznacza to, że niepoprawnie +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} +pdfTeX 3.1415926-... (TeX Live ...) +..... +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~innej (poprzedniej) instalacji. +Szczegółową analizę, gdzie pliki są szukane i~znajdowane, +umożliwia diagnostyka opisana w~części \ref{sec:debugging} na +str.~\pageref{sec:debugging}. + +\item Podgląd wyniku składu: +\begin{alltt} + > \Ucom{xdvi sample2e.dvi} # Unix + > \Ucom{dviout sample2e.dvi} # Windows +\end{alltt} +Polecenie \cmdname{xdvi} 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}. + +\item Przetwarzanie wyniku składu do \PS{} w~celu wyświetlenia lub wydruku: +\begin{alltt} +> \Ucom{dvips sample2e.dvi -o sample2e.ps} +\end{alltt} + +\item Tworzenie dokumentu bezpośrednio w~formacie \acro{PDF}: +\begin{alltt} +> \Ucom{pdflatex sample2e.tex} +\end{alltt} + +\item Podgląd dokumentu \acro{PDF}: +\begin{alltt} +> \Ucom{gv sample2e.pdf} +\textrm{lub:} +> \Ucom{xpdf sample2e.pdf} +\end{alltt} +Programy \cmdname{gv} i~\cmdname{xpdf} są zwykle dostarczane +w~ramach systemu operacyjnego, wobec tego nie zamieszczono ich +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}). +Użytkownikom Windows można zarekomendować program +Sumatra PDF (\url{http://blog.kowalczyk.info/software/sumatrapdf}. +W~systemie Windows domyślnie instalowany jest dla \TL{} 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}). + (\url{http://psview.sourceforge.net/download.html}). + +\item Inne przydatne pliki testowe: + +\begin{ttdescription} +\item [small2e.tex] przykład prostszy niż \filename{sample2e}; +\item [testpage.tex] test położenia wydruku na kartce papieru, przydatny + do sprawdzenia, czy nasza drukarka nie wprowadza przesunięć; +\item [nfssfont.tex] służy do wydruku tablic fontowych; +\item [testfont.tex] jak wyżej, z~tym że zamiast \LaTeX-a trzeba użyć plain + \TeX{}; +\item [story.tex] najbardziej kanoniczny przykład dla plain \TeX{}; + na zakończenie przetwarzania uruchomionego poleceniem \samp{tex story}, + po ukazaniu się \code{*}, należy wpisać \samp{\bs bye}. +\end{ttdescription} + +\item Jeśli zainstalowano pakiet \filename{xetex}, możemy przetestować + użycie fontów systemowych: +\begin{alltt} +> \Ucom{xetex opentype-info.tex} +This is XeTeX, Version 3.1415926\dots +... +Output written on opentype-info.pdf (1 page). +Transcript written on opentype-info.log. +\end{alltt} +Gdy otrzymamy komunikat błędu: +,,Invalid fontname `Latin Modern Roman/ICU'\dots'', oznacza to, że +należy zmienić konfigurację, jak to opisano +w~części~\ref{sec:font-conf-sys}. + +\end{enumerate} + +\subsection{Programy pomocnicze dla Windows} + +Początkującym użytkownikom polecamy stronę +\url{http://tug.org/begin.html} oraz podręcznik +Petera Flynna \textsl{Formatting Information}, dostępny pod adresem +\url{http://www.ctan.org/tex-archive/documentation/beginlatex}. + +Aby instalacja była kompletna, \TL{} wymaga kilku pomocniczych +programów, które nie są dostarczane 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. Ponadto posiadanie edytora +zorientowanego na środowisko \TeX{} znacznie ułatwi pracę. + +Wszystkie te programy dla Windows można dosyć łatwo znaleźć w~sieci, +ponieważ jednak jest ich spory wybór, postanowiliśmy te najbardziej istotne +umieścić w~dystrybucji \TL: +\begin{description} +\item[Perl i Ghostscript] -- obydwa te programy są niezbędne do +poprawnego 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 +kolidować z~ewentualnie zainstalowanymi w~systemie programami Perl +i~Ghostscript; +\item[narzędzia uruchamiane z~linii poleceń] -- zestaw kilku przydatnych + programów + (\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, + można jednak pobrać z~internetu opartą na nim przeglądarkę \acro{PDF}: + \url{http://blog.kowalczyk.info/software/sumatrapdf}); +\item[fc-list, fc-cache] -- narzędzia z~biblioteki fontconfig; program +\prog{fc-cache} rejestruje dla \XeTeX-a fonty systemowe lub dostarczane + w~dystrybucji \TL{} fonty OpenType; \prog{fc-list} wyświetla zarejestrowane + fonty, podając ich pełne nazwy (deklarujemy je w~rozszerzonym w~\XeTeX-u + poleceniu \cs{font}); +\item[PS\_View] -- program do 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 zainstalować samodzielnie. + %\end{description} + +\begin{figure}[h] +\begin{center} +\tlpng{psview}{.6\linewidth} +\caption{PS\_View: umożliwia bardzo duże powiększenia!}\label{fig:psview} +\end{center} +\end{figure} + +Poniżej zamieszczono listę miejsc, z~których można pobrać programy +pomocnicze: + +\begin{description} +\item[Ghostscript] \url{http://www.cs.wisc.edu/~ghost/} +\item[Perl] \url{http://www.perl.org} (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 + plików graficznych (\url{http://www.imagemagick.com}) +\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{}] -- spory wybór programów, uwzględniających + indywidualne preferencje użytkownika (poniżej wymieniono jedynie + te działające w~systemach Windows) + \begin{itemize*} + \item \cmdname{GNU Emacs} -- w~wersji zintegrowanej z~\textsf{AucTeX} + dla Windows dostępny jest w~archiwach \CTAN; + strona domowa: \url{http://www.gnu.org/software/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{LEd} -- polski edytor, dostępny + z~\url{http://mirror.ctan.org/support/LEd}. + \item \cmdname{SciTE} -- edytor dostępny + z \url{http://www.scintilla.org/SciTE.html} + \item \cmdname{Texmaker} -- edytor dostępny z + \url{http://www.xm1math.net/texmaker}. + \item \cmdname{TexMakerX} jest rozszerzeniem \cmdname{Texmaker} + (\url{http://texmakerx.sourceforge.net}). + \item TeXnicCenter -- kolejny, dosyć bogaty w~funkcje edytor + (\url{http://www.toolscenter.org/products/texniccenter/}) + \item \cmdname{TeXworks} -- nowy edytor, dostępny z + \url{http://tug.org/texworks} i instalowany w Windows oraz + \MacOSX\ jako część \TL. + \item \cmdname{Vim} -- rozbudowany i~bardzo funkcjonalny edytor, + wywodzący się z~klasycznego dla systemów Unix edytora \cmdname{vi} + %, dostępny na \TL{} w~katalogu \dirname{support/vim} + (\url{http://www.vim.org}) + \item \cmdname{WinShell} -- prosty edytor/shell + (\url{http://www.winshell.de}) + \item \cmdname{WinEdt} -- bogaty w~funkcje edytor dla \TeX-a, dostępny jako + \emph{shareware} (\url{http://www.winedt.com}) + \end{itemize*} +\end{description} + +Obszerniejszą listę programów można znaleźć na stronie +\url{http://tug.org/interest.html}. + +\section{Instalacje zaawansowane} + +W poprzednich częściach opisano proces typowej instalacji. Teraz +omówimy te bardziej wyspecjalizowane. + +\htmlanchor{tlsharedinstall} +\subsection{Instalacje dla wielu użytkowników (lub wieloplatformowe)} +\label{sec:sharedinstall} + +\TL{} zaprojektowano tak, by w~sieci komputerowej mogło z~niego korzystać +wielu użytkowników, nawet w~różnych systemach operacyjnych. +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 operacyjnych bądź +użytkowników wystarczy dodać do ich ścieżek przeszukiwania tylko ścieżkę +do programów \TL{}. + +Możliwa jest zatem np. instalacja lokalna \TL{}, po czym przeniesienie +całej struktury w~inne miejsce w~sieci. + +Użytkownicy Windows mogą pobrać z internetu skrypt \filename{w32client} +(patrz: \url{http://tug.org/texlive/w32client.html}), który +pozwala dostosować istniejącą instalację \TL{} dla potrzeb sieci +(włącznie z~utworzeniem skrótów w~menu systemowym). Plik .zip dostępny na +wymienionej stronie zawiera ponadto skrypt \filename{w32unclient}, +służący do odinstalowania. + +%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 +\htmlanchor{tlportable} +\subsection{Przenośna instalacja na pen drivie USB} +\label{sec:portable-tl} + +Aby wykonać przenośną instalację na pen drivie należy uruchomić program +instalacyjny z~opcją \optname{-portable} (lub polecenie \code{V} w trybie +tekstowym bądź odpowiednia opcja w trybie \GUI). Instalacja taka nie ingeruje +w sam system operacyjny. Można ją wykonać bezpośrednio na pen drivie, lub na +dysku twardym, skąd kopiujemy ją na urządzenie przenośne. + +Do uruchomienia programów \TL\ w takiej instalacji wystarczy w sesji +terminala dodać, jak zazwyczaj, odpowiedni katalog do zmiennej \code{PATH}. W +Windows należy dwukrotnie kliknąć \filename{tl-tray-menu} w głównym katalogu +instalacji, aby wybrać jedno z podstawowych zadań, pokazanych na poniższym +rysunku: + +\medskip +\tlpng{tray-menu}{4cm} +\smallskip + +\noindent Wybór ,,More\ldots'' pokaże komunikat z informacją jak można +dostosować menu do własnych potrzeb. + +\htmlanchor{tlisoinstall} +\subsection{Instalacje z pliku obrazu \ISO\ (lub \DVD)} +\label{sec:isoinstall} + +Jeśli nie zamierzamy często aktualizować bądź modyfikować w inny sposób +naszej instalacji, a~także gdy zamierzamy uruchamiać \TL\ na wielu systemach, +warto utworzyć plik obrazu \ISO\ takiej instalacji, choćby z poniższych +powodów: + +\begin{itemize} +\item kopiowanie obrazu \ISO\ między komputerami jest znacznie szybsze + niż kopiowanie zwykłej instalacji; +\item jeśli używamy kilku systemów operacyjnych na tym samym komputerze + i chcemy korzystać z~tej samej instalacji \TL, obraz \ISO instalacji + jest pozbawiony ograniczeń różnych systemów plików + (\acro{FAT32}, \acro{NTFS}, \acro{HFS+}); +\item systemy uruchamiane w trybie wirtualnym mogą po prostu zamontować + plik obrazu \ISO. +\end{itemize} + +Obraz \ISO\ można oczywiście wypalić na płytce \DVD. + +Systemy \GNU/Linux/Unix (w tym \MacOSX) pozwalają na montowanie pliku obrazu +\ISO. Prócz tego taka instalacja w niczym się nie różni od typowej, wykonanej +na dysku (patrz: \ref{sec:env}). + +Podczas wykonywania instalacji do \ISO\ warto pominąć specyfikowanie katalogu +dla roku wydania, ponadto warto umieścić katalog \filename{texmf-local} na +tym samym poziomie co inne drzewa (\filename{texmf}, \filename{texmf-dist}, +itd.). Zmianę katalogów umożliwia opcja \verb+TEXDIR+ programu instalacyjnego. + +Dla natywnego (nie wirtualnego) systemu Windows można wypalić obraz \ISO\ na +płytce \DVD, ale warto też rozważyć instalację któregoś z~dostępnych w sieci +programów umożliwiających montowanie takiego obrazu. Np. dla Windows XP +Microsoft oferuje program \filename{winxpvirtualcdcontrolpanel}. + +Poza tym w Windows można dołączyć opisany wyżej skrypt \filename{w32client} +(patrz: \ref{sec:sharedinstall} oraz +\url{http://tug.org/texlive/w32client.html}), który wykonuje swe zadania, +podobnie jak w wypadku instalacji sieciowej. + +W systemie \MacOSX{} programy TeXShop i \TeX{}works będą mogły wykorzystać +instalację na \acro{DVD}, gdy zadeklarujemy dowiązanie symboliczne +\filename{/usr/texbin} do odpowiedniego katalogu, np.: +\begin{verbatim} +sudo ln -s /Volumes/MyTeXLive/bin/universal-darwin /usr/texbin +\end{verbatim} + +Uwaga historyczna: \TL{} 2010 był pierwszą edycją, która (z różnych przyczyn) +nie była faktycznie \textit{live}. Niemniej jednak poprzednie edycje zawsze +wymagały akrobatycznych ,,sztuczek'' do uruchamiania programów bezpośrednio +z \DVD\ lub obrazu \ISO (np. deklarowania dodatkowej zmiennej środowiska). +Obraz \ISO, tworzony obecnie, tego nie wymaga. + +\htmlanchor{tlmgr} +\section{\cmdname{tlmgr}: zarządzanie instalacją} +\label{sec:tlmgr} + +\TL{} zawiera 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~przyszłości, jednakże obecnie polecanym interfejsem jest \prog{tlmgr}. Jego +możliwości obejmują: + +\begin{itemize*} +\item instalowanie, aktualizację, tworzenie kopii zapasowych, odtwarzanie + oraz usuwanie pojedynczych pakietów (opcjonalnie~-- z~uwzględnieniem + zależności pomiędzy pakietami); +\item wyszukiwanie i pokazanie zawartości pakietów; +\item wyszczególnianie oraz dodawanie architektur (platform systemowych); +\item zmianę opcji instalacji, takich jak rozmiar papieru czy zmiana + położenia źródła instalacji (patrz część~\ref{sec:location}). +\end{itemize*} + +\begin{figure}[tb] +\tlpng{tlmgr-gui}{\linewidth} +\caption{\prog{tlmgr} w~trybie graficznym: główne okno, po akcji +,,Wczytaj'' (\textit{Load}).} +\label{fig:tlmgr-gui} +\end{figure} + +\begin{figure}[tb] +\hbox to \hsize{% + \vtop{\hsize=.59\linewidth + \null % make figures align at the top + \tlpng{tlmgr-general-options}{\hsize} + \caption{\texttt{tlmgr} w trybie \GUI: Opcje ogólne} + \label{fig:tlmgr-general-options} + } + \hfil + \vtop{\hsize=.39\linewidth + \null + \tlpng{tlmgr-paper-options}{\hsize} + \caption{\texttt{tlmgr} w trybie \GUI: Opcje dotyczące formatu papieru} + \label{fig:tlmgr-paper-options} + } +} +\end{figure} + + %\begin{figure}[tb] + %\tlpng{tlmgr-config}{.8\linewidth} + %\caption{\texttt{tlmgr} w~trybie graficznym: zakładka + %konfiguracji}\label{fig:tlmgr-config} + %\end{figure} + +\subsection{\cmdname{tlmgr} -- tryb graficzny (GUI)} +\prog{tlmgr} może być uruchomiony w~trybie graficznym +(rys.~\ref{fig:tlmgr-gui}) za pomocą polecenia: +\begin{alltt} +> \Ucom{tlmgr -gui} +\end{alltt} + zaś w~systemie Windows poprzez wybór menu: \texttt{Start}, +\texttt{Programy}, \texttt{TeX Live 2012}, \texttt{TeX Live Manager}. +Po kliknięciu przycisku ,,Wczytaj'' wyświetla listę dostępnych oraz +listę zainstalowanych pakietów. + %(te ostatnie poprzedzone są znacznikiem + %,,(i)''). Zakładamy oczywiście, że źródła instalacji są poprawne i~są + %dostępne. + +Rysunki~\ref{fig:tlmgr-general-options} i~\ref{fig:tlmgr-paper-options} +pokazują zakładki doczące opcji. + +\subsection{Przykładowe wywołania \cmdname{tlmgr} z~linii poleceń} + +Po zainstalowaniu \TL{} można dokonać aktualizacji wszystkich pakietów: +\begin{alltt} +> \Ucom{tlmgr update -all} +\end{alltt} +Symulację aktualizacji umożliwia: +\begin{alltt} +> \Ucom{tlmgr update -all -dry-run} +\end{alltt} +bądź tylko wyliczenie, jakie pakiety będą aktualizowane: +\begin{alltt} +> \Ucom{tlmgr update -list} +\end{alltt} + +Poniższy przykład dodaje kolekcję zawierającą m.in. nowy ,,silnik'' \XeTeX, + %z~innego niż domyślne położenia źródła + z~lokalnego repozytorium instalacji: + +\begin{alltt} +> \Ucom{tlmgr -repository /local/mirror/tlnet install collection-xetex} +\end{alltt} +co pokazują komunikaty (tu w skrócie): +\begin{fverbatim} +install: collection-xetex +install: arabxetex +... +install: xetex +install: xetexconfig +install: xetex.i386-linux +running post install action for xetex +install: xetex-def +... +running mktexlsr +mktexlsr: Updating /usr/local/texlive/2012/texmf/ls-R... +... +running fmtutil-sys --missing +... +Transcript written on xelatex.log. +fmtutil: /usr/local/texlive/2012/texmf-var/web2c/xetex/xelatex.fmt installed. +\end{fverbatim} + +Jak widać, \prog{tlmgr} instaluje wszystkie pakiety zależne, a także +przeprowadza wymagane czynności poinstalacyjne, jak aktualizacja bazy +danych, budowa plików formatów itp. (w przykładzie wygenerowaliśmy +nowy format dla \XeTeX). + +Aby wyświetlić informację o~pakiecie (kolekcji bądź schemacie), należy +uruchomić np.: +\begin{alltt} +> \Ucom{tlmgr show collection-latexextra} +\end{alltt} +co pokaże: +\begin{fverbatim} +package: collection-latexextra +category: Collection +shortdesc: LaTeX supplementary packages +longdesc: A large collection of add-on packages for LaTeX. +installed: Yes +revision: 14675 +\end{fverbatim} + +\noindent +\textbf{Uwaga:} pełna dokumentacja programu \cmdname{tlmgr} dostępna +jest pod adresem: +\url{http://tug.org/texlive/tlmgr.html} lub po uruchomieniu: +\begin{alltt} +> \Ucom{tlmgr -help} +\end{alltt} + +\section{Uwagi dotyczące Windows} +\label{sec:windows} + +%\TL\ posiada tylko jeden program instalacyjny, działający zarówno w~Unix, +%jak i~w~Windows. Stworzenie takiego programu było możliwe dopiero +%po zaniechaniu wsparcia dla starszych wersji Windows. Obecnie +%\TL\ można instalować tylko w~Windows 2000 i~nowszych. + +\subsection{Cechy specyficzne w~systemie 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[Skojarzenia typów plików.] Jeśli wybrano tę opcję, + \prog{TeXworks}, \prog{Dviout} oraz \prog{PS\_view} otwierają domyślne + dla tych programów typy plików (lub, przy kliknięciu prawym klawiszem + myszy na danym pliku, proponują ,,Otwórz'' i wybór programu). +\item[Konwerter bitmap do EPS.] Dla różnych formatów graficznych plików + bitmapowych kliknięcie prawym klawiszem myszy wyświetla w~menu ,,Otwórz'' + \cmdname{bitmap2eps}. Bitmap2eps jest prostym skryptem, który pozwala + na wybór programu \cmdname{sam2p} bądź \cmdname{bmeps}. +\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 +odbywa się zatem w~standardowy dla Windows sposób. +\end{description} + +%\subsection{Program Dviout} +% +%Obecne wydanie \TL{} nie oferuje niestety preinstalowanego programu do +%podglądu plików \acro{DVI} dla Windows, można jednak samodzielnie +%zainstalować doskonały \prog{dviout}, autorstwa Toshio Oshimy. Znajdziemy go +%w~katalogu \path{support/dviout/}, zawierającym również krótki plik +%\filename{README} omawiający, jak zaistalować i~skonfigurować \prog{dviout} +%dla \TL. Przed instalacją zalecamy przeczytać informacje tam zawarte. +% +%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 +%poradniku \emph{on-line} tego programu. + +\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 XP jest +to zazwyczaj katalog \verb|C:\Documents and Settings\| +\verb|<nazwa_użytkownika>|, +zaś w~Windows Vista i~Windows~7 katalog +\verb|C:\Users\<nazwa_użytkownika>|. W~pliku konfiguracyjnym +\filename{texmf.cnf} i~bibliotekach \KPS{} znak \verb|~| jest poprawnie +rozwijany do odpowiedniej zmiennej zarówno w~Windows, jak i~w~Unix/Linux. + +\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 można czasem uzyskać ze zmiennych +środowiska, ale po inne informacje, np. położenie tzw. skrótów, trzeba +odwołać 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 między +użytkownikami ,,zwykłymi'' i~administratorami, mającymi +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. + Dołożono wielu starań, aby umożliwić instalację \TL{} także osobom bez + uprawnień administratora. + +Jeśli osoba instalująca jest administratorem, to udostępniona jest opcja +instalacji dla wszystkich użytkowników. Użycie jej oznacza, że tworzone są +skróty, a także ustawiane są zmienne środowiska dla całego systemu. +W~przeciwnym wypadku skróty i~menu są tworzone jedynie dla konkretnego +użytkownika, także definiowane zmienne środowiska dotyczą zwykłych +użytkowników. + %Mając uprawnienia admistratora możemy zainstalować \TL{} tylko + %dla użytkowników; należy wtedy uruchomić \prog{install-tl} z~parametrem + %\optname{-non-admin}. + +Bez względu na status użytkownika proponowanym, domyślnym katalogiem głównym +instalacji, jest katalog w~ramach \verb|%SystemDrive%|. Program instalacyjny +zawsze sprawdza, czy ten katalog jest dostępny do zapisu dla aktualnego +użytkownika. + +Problem może się pojawić wtedy, gdy użytkownik instalujący \TL{} nie jest +administratorem, a~programy \TeX-owe są już 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 nie będą znajdowane nowo instalowane +programy. Aby rozwiązać ten problem, 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. Dotyczy to także programu \TeX{}works, o ile go zainstalowaliśmy. + +Windows Vista i Windows~7 stwarzają dodatkowe utrudnienia: nawet jeśli +jesteśmy zalogowani jako administrator, musimy dodatkowo żądać uprawnień do +uruchomienia programów jako administrator! W rzeczywistości nie ma sensu +logowanie jako administrator, zamiast tego wystarczy kliknąć prawym klawiszem +myszy na programie (lub skrócie), co pozwala wybrać opcję ,,Uruchom jako +administrator''. + +\subsection{Zwiększanie maksymalnej ilości dostępnej pamięci +w~Windows i~Cygwin} +\label{sec:cygwin-maxmem} + +Użytkownicy systemów Windows i~Cygwin mogą w~przypadku uruchamiania +niektórych programów dostarczonych w~\TL{} spotkać się z~niewystarczającą +ilością dostępnej pamięci. Na przykład \prog{asy} wyczerpie dostępną pamięć +w~przypadku próby zadeklarowania macierzy składającej się z~25~milionów liczb +rzeczywistych, a~Lua\TeX\ przy przetwarzaniu dokumentu zawierającego wiele +dużych czcionek. + % XXX "dużych" jest brzydkie, ale nie mam lepszego pomysłu :/ + +W~Cygwin można ten problem rozwiązać w~sposób podany za poradą zawartą +w~Podręczniku Użytkownika Cygwin +(\url{http://www.cygwin.com/cygwin-ug-net/setup-maxmem.html}). + +W~Windows należy utworzyć plik, np. \code{moremem.reg}, o~zawartości: +\begin{sverbatim} +Windows Registry Editor Version 5.00 + +[HKEY_LOCAL_MACHINE\Software\Cygwin] +"heap_chunk_in_mb"=dword:ffffff00 +\end{sverbatim} + +\noindent a~następnie wykonać (jako użytkownik z~prawami administratora) +polecenie: \code{regedit /s moremem.reg}. Zamiast ustawień globalnych dla +systemu, można też zmienić wielkość dostępnej pamięci jedynie dla bieżącego +użytkownika, używając \code{HKEY\_CURRENT\_USER}. + +\section{W razie problemów} +\label{troubleshooting} + +\subsection{Co zrobić gdy \texttt{latex} nie może znaleźć potrzebnych +plików?} + +\begin{itemize} + \item Podstawowym narzędziem do diagnozowania problemów jest program + \cmdname{kpsewhich}. Wyprowadza on informacje diagnostyczne na wyjście +stderr, przy czym konsole (okienka wierszy poleceń) starszych systemów +Windows nie potrafią przekierować stderr do pliku. Umożliwia to dopiero +system Windows NT i~późniejsze, ale rozwiązanie przedstawione poniżej działa +dla każdej konsoli (okienka wierszy poleceń). Otóż dla celów diagnostycznych +można tymczasowo zdefiniować zmienną środowiska (w~oknie poleceń): +\begin{verbatim} +SET KPATHSEA_DEBUG_OUTPUT=err.log +\end{verbatim} +Można również zadać zakres diagnostyki: +\begin{verbatim} +SET KPATHSEA_DEBUG=-1 +\end{verbatim} + +Podobnie, aby przekierować wyjście stderr na stdout: +\begin{verbatim} +SET KPATHSEA_DEBUG_OUTPUT=con: +\end{verbatim} +W ten sposób można skierować zarówno stderr, jak i stdout do tego samego pliku. +\item Przy założeniu, że instalację wykonano w \path|c:/TeX|, należy + sprawdzić (porównać) następujące wartości:\\ + {\small + \begin{tabular}{ll} + \path|kpsewhich -expand-path $SELFAUTOPARENT| & \path|c:/TeX| \\ + \path|kpsewhich -expand-path $TEXMF| & \path|c:/TeX/texmf....| \\ + \path|kpsewhich -expand-var $TEXINPUTS| & \path|.;c:/TeX/texmf/tex//| + \end{tabular} +} + +Jeśli w otoczeniu systemowym są zdefiniowane zmienne związane z~\TeX-em, +należy je usunąć, mają bowiem pierwszeństwo przed tymi, +które określono w~pliku \filename{texmf.cnf}. +\item Następnie należy sprawdzić (porównać) wartości:\\ +{\small + \begin{tabular}{ll} + \texttt{kpsewhich cmr10.tfm} & \path|c:/TeX/texmf-dist/fonts/tfm/public/cm/cmr10.tfm|\\ + \texttt{kpsewhich latex.fmt}& \path|c:/TeX/texmf-var/web2c/pdftex/latex.fmt| + \end{tabular} +} + +Jeśli podczas sprawdzania nie znaleziono odstępstw, to \TeX{} i~programy +towarzyszące powinny działać. Jeśli tak nie jest, to 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} + +%-------------------------- +% don't use \Webc so the \uppercase in the headline works. +\section{Instrukcja obsługi systemu Web2C} + +\Webc{} to zestaw programów związanych z~\TeX-em, tj. sam \TeX{}, \MF{}, +\MP, \BibTeX{} itd. Stanowią one rdzeń dystrybucji \TL. + +Oryginalna implementacja wykonana została przez Tomasa Rokickiego, który +w~roku 1987 stworzył pierwszy system \TeX{}-to-C, adaptując pliki wymiany +(\emph{change files}) pod Unix-em (pierwotnie były one dziełem Howarda +Trickey'a oraz Pavela Curtisa). W~czasie, gdy Tim Morgan zajmował się +systemem, jego nazwa została zmieniona na Web-to-C\@. W~1990 roku prace nad +projektem przejął Karl Berry wraz z~dziesiątkami współpracowników, a~w~roku +1997 pałeczkę przejął Olaf Weber. + +\Webc{} działa na platformach systemowych, takich jak Unix (w~tym \MacOSX), +Windows 9x/\acro{NT/2K/XP} i~innych. +System wykorzystuje oryginalne źródła \TeX-owe autorstwa Donalda Knutha +oraz inne programy napisane w~\web{} i~tłumaczy je na kod źródłowy~C. +Ponadto system udostępnia spory zestaw makr i~funkcji stworzonych dla +zwiększenia funkcjonalności oryginalnych zasobów oprogramowania +związanego z~\TeX-em. Podstawowymi składnikami systemu są: + +\begin{cmddescription} +\item[bibtex] tworzenie spisów bibliograficznych; +\item[dvicopy] modyfikowanie pliku \dvi; +\item[dvitomp] konwersja \dvi{} do MPX (rysunki \MP{}-owe); +\item[dvitype] konwersja \dvi{} na plik tekstowy (ASCII); +\item[gftodvi] zamiana fontu GF na plik \dvi; +\item[gftopk] zamiana fontu w~formacie GF na font spakowany (PK); +\item[gftype] zamiana fontu GF na plik tekstowy (ASCII); +\item[mf] generowanie fontów bitmapowych w formacie GF; +\item[mft] skład plików źródłowych \MF{}-a; +\item[mpost] tworzenie rysunków oraz diagramów technicznych; +\item[patgen] tworzenie wzorców przenoszenia wyrazów; +\item[pktogf] zamiana fontów w formacie PK na fonty GF; +\item[pktype] zamiana fontu PK na plik tekstowy (ASCII); +\item[pltotf] konwersja tekstowej listy właściwości do TFM; +\item[pooltype] wyświetlanie \web-owych plików pool; +\item[tangle] konwersja \web{} do języka Pascal; +\item[tex] skład tekstu; +\item[tftopl] konwersja TFM do tekstowej listy właściwości (PL); +\item[vftovp] konwersja fontów wirtualnych do wirtualnej listy + właściwości (VPL); +\item[vptovf] konwersja wirtualnej listy właściwości do fontów wirtualnych; +\item[weave] konwersja \web{} do \TeX-a. +\end{cmddescription} + +\noindent +Dokładny opis funkcji oraz składni tych programów zawarty jest +w~dokumentacji poszczególnych pakietów samego \Webc{}. +Do optymalnego korzystania z~instalacji \Webc{} +przyda się znajomość kilku zasad rządzących całą rodziną programów. + +Wszystkie programy obsługują standardowe opcje \acro{GNU}: +\begin{description} +\item[\texttt{-{}-help\ \ \ }] podaje podstawowe zasady użytkowania; +\item[\texttt{-{}-verbose}] podaje dokładny raport z~działania programu; +\item[\texttt{-{}-version}] podaje informację o~wersji, po czym kończy + działanie programu. +\end{description} + +Do lokalizowania plików programy oparte na \Webc{} używają biblioteki do +przeszukiwania ścieżek zwanej \KPS{}. +Dla optymalizacji przeszukiwania \TeX-owego drzewa podkatalogów biblioteka ta +używa kombinacji zmiennych środowiskowych oraz kilku plików konfiguracyjnych. +\Webc{} potrafi obsługiwać jednocześnie więcej niż jedno drzewo +podkatalogów, co jest użyteczne w~wypadku, gdy chce się przechowywać +standardową dystrybucję \TeX-a jak i~lokalne rozszerzenia w~dwóch różnych +drzewach katalogów. +Aby przyspieszyć poszukiwanie plików, katalog główny każdego drzewa ma swój +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{}. + +Tym, co nazywamy \emph{ścieżką przeszukiwania}, jest rozdzielona dwukropkami +lub średnikami lista \emph{elementów ścieżki}, które zasadniczo są nazwami +podkatalogów. Ścieżka przeszukiwania może pochodzić z~(kombinacji) wielu +źródeł. Przykładowo, aby odnaleźć plik \samp{my-file} w~ścieżce +\samp{.:/dir}, \KPS{} sprawdza istnienie danego elementu ścieżki +w~następującej kolejności: najpierw \file{./my-file}, potem +\file{/dir/my-file}, zwracając pierwszy odnaleziony (lub możliwie wszystkie). + +Aby optymalnie zaadaptować się do konwencji wszystkich systemów operacyjnych, +na systemach nieunixowych \KPS{} może używać +jako separatorów nazw ścieżek znaków innych +niż dwukropek (\samp{:}) oraz ,,ciach'' (\samp{/}). + +W~celu sprawdzenia konkretnego elementu \var{p} ścieżki, \KPS{} najpierw +sprawdza, czy zbudowana wcześniej baza danych (patrz ,,Baza nazw plików'' na +str.~\pageref{Filename-database}) odnosi sie do \var{p}, tj. +czy baza danych znajduje się w~podkatalogu z~prefiksem~\var{p}. +Jeżeli tak, to specyfikacja ścieżki jest porównywana z~zawartością bazy. + +Jeśli baza danych nie istnieje bądź nie odnosi się do danego elementu +ścieżki albo też nie zawiera elementów zgodnych, to przeszukiwany jest system +plików (jeżeli nie zostało to zabronione przez specyfikację rozpoczynającą +się od~\samp{!!}\ oraz jeżeli poszukiwany plik musi istnieć). +\KPS{} konstruuje listę podkatalogów, które korespondują z~danym elementem +ścieżki, a~następnie sprawdza w~każdym z~nich, czy nie ma tam poszukiwanego +pliku. + +Warunek mówiący, że ,,plik musi istnieć'' dotyczy np. plików \samp{.vf} +i~plików dołączanych \TeX-owym poleceniem \cs{openin}. +Takiego pliku może nie być (np. \file{cmr10.vf}), błędne byłoby zatem +poszukiwanie go na dysku. +Jeśli więc zapomnisz o~aktualizacji \file{ls-R} po instalacji nowego +pliku \samp{.vf}, to nie zostanie on odnaleziony. +Każdy element ścieżki sprawdzany jest w~następującej kolejności: najpierw +w~bazie danych, potem na dysku. +Jeżeli plik się znajdzie, to przeszukiwanie zostanie zatrzymane i~zwrócony +zostanie wynik. + +Ponieważ najprostszym i~najbardziej powszechnym elementem ścieżki jest +nazwa katalogu, \KPS{} korzysta z~dodatkowych możliwości w~przeszukiwaniu +ścieżek: +wielowarstwowych wartości domyślnych, zmiennych środowiskowych, wartości +pliku konfiguracyjnego, lokalnych +podkatalogów użytkownika oraz rekursywnego przeszukiwania podkatalogów. +Można więc powiedzieć, że \KPS{} \emph{rozwija} element ścieżki, tzn. +transformuje wszystkie specyfikacje do podstawowej nazwy lub nazw katalogów. +Jest to opisane w~kolejnych akapitach, w~kolejności w~jakiej to zachodzi. + +Trzeba zauważyć, że jeżeli nazwa poszukiwanego pliku jest +absolutna lub jawnie względna, tj. zaczyna się od \samp{/} lub \samp{./} +lub \samp{../}, to \KPS{} ogranicza się do sprawdzenia, czy ten plik istnieje. + +\ifSingleColumn +\else +\begin{figure*} +\verbatiminput{examples/ex5.tex} +\setlength{\abovecaptionskip}{0pt} + \caption{Przykład pliku konfiguracyjnego} + \label{fig:config-sample} +\end{figure*} +\fi + +\subsubsection{Źródła ścieżek} +\label{Path-sources} + +Nazwa przeszukiwanej ścieżki może pochodzić z~wielu źródeł. +Oto kolejność, w~jakiej \KPS{} ich używa: + +\begin{enumerate} +\item + Zmienna środowiskowa ustawiana przez użytkownika, np. + \envname{TEXINPUTS}. + Zmienne środowiskowe z~dołączoną kropką i~nazwą programu zastępują inne, + np. jeżeli \samp{latex} jest nazwą uruchomionego programu, wtedy zamiast + \envname{TEXINPUTS} wykorzystana zostanie zmienna \envname{TEXINPUTS.latex}. +\item + Plik konfiguracyjny konkretnego programu, np. linia ,,\texttt{S /a:/b}'' + w~pliku \file{config.ps} programu \cmdname{dvips}. +\item Plik konfiguracyjny \KPS{} \file{texmf.cnf}, zawierający taką linię, + jak \samp{TEXINPUTS=/c:/d} (patrz poniżej). +\item Wartości domyślne dla uruchamianych programów. +\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 +str.~\pageref{sec:debugging}). + +\subsubsection{Pliki konfiguracyjne} + +\tolerance=3500 + \KPS{} szuka ścieżek przeszukiwania i~innych definicji w~\emph{plikach +konfiguracyjnych} o~nazwach \file{texmf.cnf}. +Ścieżka przeszukiwania używana do znajdowania tych plików określana jest +przez zmienną \envname{TEXMFCNF}, + %(domyślnie taki plik znajduje się + %w~podkatalogu \file{texmf/web2c}). + ale nie zalecamy jawnego ustawiania tej, jak i~innych zmiennych w~systemie. +Zamiast tego typowa instalacja \TL{} tworzy plik \file{.../2012/texmf.cnf}, +który w~wyjątkowych wypadkach możemy modyfikować. Głównym plikiem +konfiguracyjnym jest \file{.../2012/texmf/web2c/texmf.cnf}, ale +nie powinien być on modyfikowany, gdyż + %wprowadzone ewentualne + zmiany będą utracone podczas aktualizacji. + +Czytane będą \emph{wszystkie} pliki \file{texmf.cnf} w~ścieżce +przeszukiwania, a~definicje we wcześniejszych plikach zastąpią te +w~późniejszych. Tak więc w~ścieżce \verb|.:$TEXMF| wartości pochodzące +z~\file{./texmf.cnf} zastąpią te z~\verb|$TEXMF/texmf.cnf|. + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +Dociekliwy czytelnik może być zainteresowany sposobem, w~jaki programy +znajdują plik \file{texmf.cnf}, skoro nie ma konieczności deklarowania +specyficznej zmiennej środowiskowej systemu. Otóż położenie domyślne jest +wkompilowane w~programy jako względne do ich położenia (określanego, jak +wiemy, w~ścieżce specyfikowanej przez \texttt{\$PATH}): +\path{../../texmf/web2c/} bądź \path{../texmf/web2c/}. Jeśli jawnie +deklarujemy zmienną \envname{TEXMFCNF}, wymagane jest podanie bezwzględnej +ścieżki. + +Czytając zamieszczony poniżej opis formatu pliku \file{texmf.cnf}, +warto przeglądać jego zawartość. Położenie \emph{aktywnego} pliku +znajdziemy za pomocą polecenia \texttt{kpsewhich texmf.cnf}. + +\begin{itemize} +\item + Komentarze zaczynają się od ,,\texttt{\%}'', a~kończą na końcu wiersza. +\item + Puste wiersze nie są brane pod uwagę. +\item + Znak ,,\bs{}'' na końcu wiersza działa jako znak kontynuacji, tzn. + oznacza, że kolejny wiersz jest kontynuacją bieżącego. + Spacja na początku kolejnego wiersza nie jest ignorowana. +\item + Pozostałe wiersze mają postać: +\begin{alltt} + \emph{zmienna}[.\emph{program}] [=] \emph{wartość} +\end{alltt}% + gdzie \samp{=} i~otaczające spacje są opcjonalne. +\item + ,,\texttt{\var{zmienna}}'' zawierać może dowolne znaki poza spacją, + \samp{=}, lub \samp{.} (kropką), najbezpieczniej jednak używać znaków + z~zakresu \samp{A-Za-z\_}. +\item + Napis ,,\texttt{.\var{program}}'' ma zastosowanie w~wypadku, gdy + uruchamiany program nosi nazwę \texttt{\var{program}} lub + \texttt{\var{program}.exe}. Pozwala to różnym odmianom \TeX-a stosować + różne ścieżki przeszukiwania. +\item ,,\texttt{\var{wartość}}'' zawierać może dowolne znaki poza + ,,\texttt{\%}'' i \samp{@}. + Nie można używać konstrukcji ,,\texttt{\$\var{zmienna}.\var{program}}'' + po prawej stronie. Zamiast tego trzeba zastosować zmienną pomocniczą. + Jeżeli systemem operacyjnym jest Unix, + to średnik \samp{;}\ użyty w~,,\texttt{\var{wartość}}'' zamieniany jest na + \samp{:}; umożliwia to istnienie + wspólnego pliku \file{texmf.cnf} dla systemów Unix oraz Windows. +\item + Wszystkie definicje czytane są zanim cokolwiek zostanie rozwinięte, tak + więc do zmiennych można się odwoływać przed ich zdefiniowaniem. +\end{itemize} +Oto fragment pliku konfiguracyjnego ilustrujący większość opisanych powyżej +reguł notacji: +\ifSingleColumn +\verbatiminput{examples/ex5.tex} +\else +jest pokazany na rys.~\ref{fig:config-sample}. +\fi + +\subsubsection{Rozwijanie ścieżek} +\label{Path-expansion} + +\KPS{} rozpoznaje w~ścieżkach przeszukiwania pewne specjalne znaki oraz +konstrukcje, podobne do tych, które są dostępne w~powłokach systemów +typu Unix. +Jako ogólny przykład: złożona ścieżka +\verb+~$USER/{foo,bar}//baz+ rozwija się do wszystkich podkatalogów pod +katalogami \file{foo} i~\file{bar} w~katalogu głównym \texttt{\$USER}, +które zawierają katalog lub plik \file{baz}. +Rozwinięcia te opisane są w~poniższych podrozdziałach. + +\subsubsection{Rozwijanie domyślne} +\label{Default-expansion} + +\tolerance=2500 +Jeżeli ścieżka przeszukiwania największego uprzywilejowania (patrz ,,Źródła +ścieżek'' na str.~\pageref{Path-sources}) zawiera +\emph{dodatkowy dwukropek} (np. na początku, na końcu lub podwójny), to \KPS{} +wstawia w~tym miejscu następną zdefiniowaną w~hierarchii uprzywilejowania +ścieżkę przeszukiwania. +Jeżeli ta wstawiona ścieżka ma dodatkowy dwukropek, to dzieje się dalej to samo. +Przykładowo, jeżeli ustawić zmienną środowiskową +\tolerance=1500 + +\begin{alltt} +> \Ucom{setenv TEXINPUTS /home/karl:} +\end{alltt} +oraz wartość \code{TEXINPUTS} pobraną z~\file{texmf.cnf} + +\begin{alltt} + .:\$TEXMF//tex +\end{alltt} +to końcową wartością użytą w~przeszukiwaniu będzie: + +\begin{alltt} + /home/karl:.:\$TEXMF//tex +\end{alltt} + +Ponieważ nieużytecznym byłoby wstawiać wartość domyślną w~więcej niż jednym +miejscu, \KPS{} zmienia tylko jeden dodatkowy \samp{:}\ i~pozostawia +inne bez zmian. \KPS{} najpierw szuka dwukropków na początku linii, potem na końcu, +a~następnie podwójnych. + +\subsubsection{Rozwijanie nawiasów} +\label{sec:brace-expansion} + +Użyteczna jest możliwość rozwijania nawiasów, co oznacza, że np. +\verb+v{a,b}w+ rozwija się do \verb+vaw:vbw+. +Nawiasy można też zagnieżdżać. +Funkcji tej można użyć do zaimplementowania różnych hierarchii \TeX-owych +przez przypisanie listy nawiasów do \code{\$TEXMF}. Przykładowo, +w~pliku \file{texmf.cnf} można znaleźć następującą (uproszczoną tu) +definicję: +\begin{verbatim} + TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN} +\end{verbatim} +Używając jej, można następnie napisać coś w~rodzaju: +\begin{verbatim} + TEXINPUTS = .;$TEXMF/tex// +\end{verbatim} +co oznacza, że po szukaniu w~katalogu bieżącym będą przeszukane kolejno +\code{\$TEXMFHOME/tex}, \code{\$TEXMFLOCAL/tex}, \code{\$TEXMFVAR/tex} +i~\code{\$TEXMFMAIN/tex} (wszystkie wraz z~katalogami niższego poziomu; +dwie ostatnie ścieżki \emph{wyłącznie} na podstawie zawartości +pliku \file{ls-R}). +Jest to wygodny sposób na uruchamianie dwóch równoległych struktur \TeX-owych, +jednej ,,zamrożonej'' (np. na \CD), a~drugiej ciągle uaktualnianej nowo +pojawiającymi się wersjami. +Używając zmiennej \code{\$TEXMF} we wszystkich definicjach daje pewność, +że najpierw przeszukiwane jest drzewo uaktualnione. + +\subsubsection{Rozwijanie podkatalogów} +\label{Subdirectory-expansion} + +Dwa lub więcej kolejnych ,,ciachów'' (,,/'') w~elemencie ścieżki, +występujących po nazwie katalogu~\var{d}, zastępowanych jest przez wszystkie +podkatalogi~\var{d}, najpierw podkatalogi znajdujące się bezpośrednio +pod~\var{d}, potem te pod powyższymi i~tak dalej. Na każdym etapie +kolejność, w~jakiej przeszukiwane są katalogi, jest \emph{nieokreślona}. + +Jeśli wyszczególni się człony nazwy pliku po \samp{//}, to uwzględnione zostaną +tylko te podkatalogi, które zawierają powyższe człony. +Na przykład \samp{/a//b} rozwija się do katalogów \file{/a/1/b}, +\file{/a/2/b}, \file{/a/1/1/b} itd., ale nie do \file{/a/b/c} czy \file{/a/1}. + +Możliwe jest wielokrotne użycie \samp{//} w~ścieżce, jednakże \samp{//} +występujące na początku ścieżki nie jest brane pod uwagę. + +\subsubsection{Lista znaków specjalnych i~ich znaczeń -- podsumowanie} + +Poniższa lista podsumowuje znaczenie znaków specjalnych w~plikach +konfiguracyjnych. + +\newcommand{\CODE}[1]{\makebox[2.2em][l]{\code{#1}}} +\begin{description} +\item[\CODE{:}] znak rozdzielający w~specyfikacji ścieżki; umieszczony na + początku lub na końcu ścieżki zastępuje domyślne rozwinięcie ścieżki; +\item[\CODE{;}] znak rozdzielający dla systemów nieuniksowych + (działa tak jak ,,\code{:}''); +\item[\CODE{\$}] rozwijanie zmiennej; +\item[\CODE{\string~}] oznacza katalog główny użytkownika; +\item[\CODE{\char`\{\dots\char`\}}] rozwijanie nawiasów, np. + \verb+a{1,2}b+ zmieni się w~\verb+a1b:a2b+; +\item[\CODE{//}] rozwijanie podkatalogów (może wystąpić gdziekolwiek + w~ścieżce, poza jej początkiem); +\item[\CODE{\%}] początek komentarza, obejmującego wszystkie znaki do końca + linii; +\item[\CODE{\bs}] znak kontynuacji (pozwala na przełamanie wiersza + z~wyrażeniem); +\item[\CODE{!!}] przeszukiwanie \emph{tylko} bazy danych, + a~\emph{nie} dysku. +\end{description} + + +\subsection{Bazy nazw plików} +\label{Filename-database} + +Podczas przeszukiwania \KPS{} stara się zminimalizować dostęp do dysku. +Niemniej, w~przypadku instalacji ze zbyt dużą liczbą katalogów +przeglądanie każdego dopuszczalnego katalogu w~poszukiwaniu pliku może +zabierać sporo czasu (ma to miejsce zwłaszcza, jeżeli przeszukać trzeba setki +katalogów z~fontami). +Dlatego też \KPS{} może używać zewnętrznego pliku z~,,bazą danych'' +o~nazwie \file{ls-R}, który zawiera przypisania plików do katalogów. +Unika się w~ten sposób czasochłonnego przeszukiwania dysku. + +Drugi plik z~bazą danych -- \file{aliases} -- pozwala na nadawanie +dodatkowych nazw plikom zawartym w~\file{ls-R}. +Może to być pomocne do adaptacji do DOS-owej konwencji ,,8.3'' nazewnictwa +plików w~plikach źródłowych. + +\subsubsection{Baza nazw plików} +\label{ls-R} + +Jak wspomniano, plik zawierający główną bazę nazw +plików musi nosić nazwę \file{ls-R}. +W~katalogu podstawowym każdej hierarchii \TeX-owej (domyślnie \code{\$TEXMF}), +którą chcemy włączyć w~mechanizm przeszukiwania, umieszczać można po jednym +pliku \file{ls-R}; w~większości przypadków istnieje tylko jedna hierarchia. +\KPS{} szuka pliku \file{ls-R} w~ścieżce \code{TEXMFDBS}. + +Najlepszym sposobem stworzenia i~utrzymywania pliku \file{ls-R} jest +uruchomienie skryptu \code{mktexlsr}, będącego składnikiem dystrybucji. +Jest on wywoływany przez różne skrypty typu \samp{mktex...}. +W~zasadzie skrypt ten jedynie wykonuje polecenie +\begin{alltt} +cd \var{/your/texmf/root} && ls -LAR ./ >ls-R +\end{alltt} +zakładając, że polecenie \code{ls} danego systemu utworzy właściwy format +strumienia wyjściowego (\acro{GNU} \code{ls} działa prawidłowo). +Aby mieć pewność, że baza danych jest zawsze aktualna, wygodnie jest + przebudowywać ją regularnie za pomocą demona \code{cron}. + %tak że wraz ze zmianami + %w~instalowanych plikach -- np. po instalacji lub uaktualnianiu pakietu + %\LaTeX{} -- plik \file{ls-R} jest uaktualniany automatycznie. + +Jeśli pliku nie ma w~bazie danych, \KPS{} domyślnie przechodzi do +przeszukiwania dysku. Jeżeli jednak dany element ścieżki zaczyna sie od +\samp{!!}, to w~poszukiwaniu tego elementu sprawdzona zostanie \emph{jedynie} +baza danych, a~nigdy dysk. + +\subsubsection{kpsewhich -- program do przeszukiwania ścieżek} +\label{Invoking-kpsewhich} + +Przeszukiwanie ścieżek przez program \texttt{kpsewhich} jest niezależne od +jakiejkolwiek aplikacji. +Może on być przydatny jako rodzaj programu \code{find}, za pomocą którego +lokalizować można pliki w~hierarchiach \TeX-owych (jest on używany +intensywnie w~skryptach \samp{mktex...} tej dystrybucji). + +\begin{alltt} +> \Ucom{kpsewhich \var{opcje}\dots{} \var{nazwa-pliku}\dots{}} +\end{alltt} +Parametry wyszczególnione w~,,\texttt{\var{opcje}}'' mogą zaczynać się zarówno od +\samp{-}, jak i~od \samp{-{}-}, a~dozwolony jest każdy jednoznaczny skrót. + +\KPS{} traktuje każdy argument niebędący parametrem jako nazwę pliku +i~zwraca pierwszą odnalezioną nazwę. +Nie ma parametru nakazującego zwracanie wszystkich nazw plików o~określonej +nazwie (w~tym celu można wykorzystać Unix-owy program \samp{find}). + +Oto ważniejsze parametry. + +\begin{ttdescription} +\item[\texttt{-{}-dpi=\var{num}}]\mbox{}\\* + Ustaw rozdzielczość na ,,\texttt{\var{num}}''; ma to tylko wpływ na + przeszukiwanie fontów \samp{gf} i~\samp{pk}. Dla zgodności + z~\cmdname{dvips} parametr + \samp{-D} działa identycznie. Domyślną wartością jest 600. +\item[\texttt{-{}-format=\var{nazwa}}]\mbox{}\\ + Ustawienie formatu (typu pliku) przeszukiwania na ,,\texttt{\var{nazwa}}''. + Domyślnie format odgadywany jest z~nazwy pliku. + Dla formatów, które nie mają przydzielonego jednoznacznego rozszerzenia, + takich jak niektóre pliki \MP{}-owe czy pliki konfiguracyjne + \cmdname{dvips}-a, należy wyszczególnić nazwę, których listę wyświetli + uruchomienie \texttt{kpsewhich -{}-help}. + +\item[\texttt{-{}-mode=\var{napis}}]\mbox{}\\* + Ustaw nazwę trybu na ,,\texttt{\var{napis}}''; dotyczy to jedynie szukania + fontów \samp{gf} oraz \samp{pk}. + Brakuje wartości domyślnej -- odnaleziony zostanie dowolny + wyszczególniony tryb. +\item[\texttt{-{}-must-exist}]\mbox{}\\ + Zrób wszystko co możliwe, aby odnaleźć pliki, włączając w~to przede wszystkim + przeszukanie dysku. + Domyślnie, w~celu zwiększeniu efektywności działania, sprawdzana jest + tylko baza \file{ls-R}. +\item[\texttt{-{}-path=\var{napis}}]\mbox{}\\ + Szukaj w~ścieżce ,,\texttt{\var{napis}}'' (rozdzielonej, jak + zwykle, dwukropkami), zamiast zgadywać ścieżkę przeszukiwania z~nazwy + pliku. + \samp{//} i~wszystkie zwykłe rozszerzenia są możliwe. + Parametry \samp{-{}-path} oraz \samp{-{}-format} wzajemnie się wykluczają. +\item[\texttt{-{}-progname=\var{nazwa}}]\mbox{}\\ + Ustaw nazwę programu na ,,\texttt{\var{nazwa}}''. + Może to mieć wpływ na ścieżkę przeszukiwania poprzez + ,,\texttt{.\var{program}}'' w~plikach konfiguracyjnych. + Ustawieniem domyślnym jest \samp{kpsewhich}. +\item[\texttt{-{}-show-path=\var{nazwa}}]\mbox{}\\ + Pokazuje ścieżkę używaną do poszukiwania plików typu + ,,\texttt{\var{nazwa}}''. + Użyć można zarówno rozszerzenia (\samp{.pk}, \samp{.vf}, etc.), jak + i~nazwy pliku, tak jak w~wypadku parametru \samp{-{}-format}. +\item[\texttt{-{}-debug=\var{num}}]\mbox{}\\ + ustawia parametry wykrywania błędów na ,,\texttt{\var{num}}''. +\end{ttdescription} + +%Zmienne środowiskowe domyślnie ustawiane są w~pliku konfiguracyjnym +%\file{texmf.cnf}. W~wypadku gdy chce się unieważnić wartości zmiennych +%wyszczególnione w~tym pliku, można narzucić ich ustawienie w~środowisku, +%w~którym uruchamiane są programy. + +\subsubsection{Przykłady użycia} +\label{SExamplesofuse} + +Przyjrzyjmy sie teraz, jak działa \KPS{}. + +\begin{alltt} +> \Ucom{kpsewhich article.cls} +/usr/local/texmf-dist/tex/latex/base/article.cls +\end{alltt} +Szukamy tu pliku \file{article.cls}. +Ponieważ rozszerzenie \samp{.cls} jest jednoznaczne, nie musimy zaznaczać, że +poszukujemy pliku typu ,,tex'' (katalogi plików źródłowych \TeX-a). +Znajdujemy go w~podkatalogu \file{tex/latex/base}, pod katalogiem nadrzędnym +\samp{texmf-dist}. +Podobnie wszystkie poniższe pliki odnajdywane są bez\-pro\-ble\-mo\-wo +dzięki swoim jednoznacznym rozszerzeniom: +\begin{alltt} +> \Ucom{kpsewhich array.sty} +/usr/local/texmf-dist/tex/latex/tools/array.sty +> \Ucom{kpsewhich latin1.def} +/usr/local/texmf-dist/tex/latex/base/latin1.def +> \Ucom{kpsewhich size10.clo} +/usr/local/texmf-dist/tex/latex/base/size10.clo +> \Ucom{kpsewhich small2e.tex} +/usr/local/texmf-dist/tex/latex/base/small2e.tex +> \Ucom{kpsewhich tugboat.bib} +/usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib +\end{alltt} + +\noindent (ostatni plik to \BibTeX-owa baza bibliograficzna dla artykułów +\textsl{TUGBoat}). + +\begin{alltt} +> \Ucom{kpsewhich cmr10.pk} +\end{alltt} +Pliki czcionek bitmapowych typu \file{.pk} używane są przez sterowniki, + % ??? dvips to chyba nie przeglądarka --- + % w oryg. było display programs like dvips... + takie jak \cmdname{dvips} czy \cmdname{xdvi}. +W~tym wypadku wynik przeszukiwania okaże się pusty, ponieważ +w~systemie brak gotowych wygenerowanych czcionek \samp{.pk} Computer Modern +(wynika to z~faktu używania w~\TL{} fontów PostScript-owych Type1). +\begin{alltt} +> \Ucom{kpsewhich wsuipa10.pk} +\ifSingleColumn /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk +\else /usr/local/texmf-var/fonts/pk/ljfour/public/ +..... wsuipa/wsuipa10.600pk +\fi\end{alltt} +Dla tych fontów (alfabetu fonetycznego) musieliśmy wygenerować pliki +\samp{.pk}, a~ponieważ domyślnym \MF{}-owym trybem naszej instalacji jest +\texttt{ljfour} z~podstawową rozdzielczością 600dpi, zwracany jest taki +właśnie wynik. +\begin{alltt} +> \Ucom{kpsewhich -dpi=300 wsuipa10.pk} +\end{alltt} +W~tym wypadku, kiedy zaznaczamy, że interesuje nas rozdzielczość +300dpi (\texttt{-dpi=300}), to widzimy, że w~naszej instalacji taka +czcionka nie jest dostępna. +Program taki jak \cmdname{dvips} czy \cmdname{xdvi} zatrzymałby się, aby +utworzyć pliki \texttt{.pk} w~wymaganej rozdzielczości (używając skryptu +\cmdname{mktexpk}). + +Przeanalizujmy teraz pliki nagłówkowe i~konfiguracyjne +programu \cmdname{dvips}. +Najpierw szukamy pliku PostScript-owego prologu \file{tex.pro}, +wykorzystywanego dla potrzeb \TeX-a. Drugi przykład pokazuje +poszukiwanie pliku konfiguracyjnego \file{config.ps}, zaś trzeci -- +szukanie pliku mapy czcionek PostScriptowych \file{psfonts.map} +(począwszy od obecnej edycji, pliki \file{.map} i~\file{.enc} +mają własne reguły przeszukiwania ścieżek i~zmienione położenie w~ramach +drzew \dirname{texmf}). +Ponieważ rozszerzenie \samp{.ps} nie jest jednoznaczne, musimy +wyraźnie zaznaczyć, jaki typ jest wymagany dla pliku +\texttt{config.ps} (,,\texttt{dvips config}''). +\begin{alltt} +> \Ucom{kpsewhich tex.pro} +/usr/local/texmf/dvips/base/tex.pro +> \Ucom{kpsewhich --format="dvips config" config.ps} +/usr/local/texmf-var/dvips/config/config.ps +> \Ucom{kpsewhich psfonts.map} +/usr/local/texmf-var/fonts/map/dvips/updmap/psfonts.map +\end{alltt} + +Następnie przyjrzyjmy się bliżej plikom pomocniczym fontów Times z~kolekcji +URW. W~standardzie nazewnictwa fontów mają one prefiks \samp{utm}. +Pierwszy plik, którego szukamy, to plik konfiguracyjny, zawierający nazwę +pliku z~przemapowaniem fontów: +\begin{alltt} +> \Ucom{kpsewhich --format="dvips config" config.utm} + /usr/local/texmf-dist/dvips/psnfss/config.utm +\end{alltt} +W~pliku tym znajduje się wiersz: +\begin{alltt} + p +utm.map +\end{alltt} +wskazujący na plik \file{utm.map}, który chcemy zlokalizować w~następnej +kolejności: +\begin{alltt} +> \Ucom{kpsewhich utm.map} + /usr/local/texmf-dist/fonts/map/dvips/times/utm.map +\end{alltt} +Plik z~przemapowaniem definiuje nazwy czcionek PostScriptowych Type1 +w~zestawie fontów URW, zaś jego zawartość wygląda następująco +(pokazane są tylko fragmenty wierszy): +\begin{alltt} +utmb8r NimbusRomNo9L-Medi ... <utmb8a.pfb +utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb +utmr8r NimbusRomNo9L-Regu ... <utmr8a.pfb +utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb +utmbo8r NimbusRomNo9L-Medi ... <utmb8a.pfb +utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb +\end{alltt} +Używając przeszukiwania plików z~fontami Type1, znajdźmy font +Times Roman \file{utmr8a.pfb} w~drzewie katalogów \file{texmf}: +\begin{alltt} +> \Ucom{kpsewhich utmr8a.pfb} +\ifSingleColumn /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb +\else /usr/local/texmf-dist/fonts/type1/ +... urw/utm/utmr8a.pfb +\fi\end{alltt} + +Powyższe przykłady pokazują, jak łatwo można znajdować lokalizację danego +pliku. Jest to ważne zwłaszcza wówczas, gdy istnieje podejrzenie, że gdzieś +zawieruszyła się błędna wersja jakiegoś pliku; \cmdname{kpsewhich} pokaże tylko +pierwszy napotkany plik. + +\subsubsection{Diagnostyka błędów} +\label{sec:debugging} + +Czasami niezbędne są informacje o~tym, jak program sobie radzi +z~odniesieniami do plików. Aby dało się je uzyskać w~wygodny sposób, +\KPS{} oferuje różne poziomy diagnostyki błędów: +\begin{itemize} +\item[\texttt{\ 1}] wywołania \texttt{stat} (testy pliku). Podczas + uruchamiania z~uaktualnioną bazą danych \file{ls-R} nie powinno to + przeważnie dawać żadnego wyniku. +\item[\texttt{\ 2}] Zapis odwołań do tablic asocjacyjnych (\emph{hash + tables}), takich jak baza \file{ls-R}, pliki przemapowań, pliki konfiguracyjne. +\item[\texttt{\ 4}] Operacje otwarcia i~zamknięcia pliku. +\item[\texttt{\ 8}] Ogólne informacje o~ścieżkach dla typów + plików szukanych przez \KPS; użyteczne do znalezienia ścieżki + zdefiniowanej dla danego pliku. +\item[\texttt{16}] Lista katalogów dla każdego z~elementów ścieżki + (odnosi się tylko do poszukiwań na dysku). +\item[\texttt{32}] Poszukiwania plików. +\end{itemize} +Wartość \texttt{-1} ustawia wszystkie powyższe opcje -- w~praktyce, +poszukując przyczyny błędów, prawdopodobnie będziesz zawsze używać +tych poziomów. + +Podobnie w~przypadku programu \cmdname{dvips}, ustawiając kombinację +przełączników wykrywania błędów, można dokładnie śledzić, skąd pochodzą pliki. +W~sytuacji gdy plik nie zostanie odnaleziony, widać, w~których katalogach +program szukał danego pliku, dzięki czemu można się zorientować, w~czym +problem. + +Ogólnie mówiąc, ponieważ programy odwołują się wewnętrznie do +biblioteki \KPS{}, opcje wykrywania błędów można wybrać przy użyciu +zmiennej środowiskowej \envname{KPATHSEA\_DEBUG}, ustawiając ją +na opisaną powyżej wartość (kombinację wartości). + +\noindent +\textbf{Uwaga dla użytkowników Windows:} w~systemie tym niełatwo +przekierować komunikaty programu do pliku. Do celów diagnostycznych +można chwilowo ustawić zmienne (w~oknie CMD): +\begin{verbatim} +SET KPATHSEA_DEBUG_OUTPUT=err.log +SET KPATHSEA_DEBUG=-1 +\end{verbatim} + +Rozważmy na przykład mały \LaTeX-owy plik źródłowy \file{hello-world.tex}, +który zawiera: +\begin{verbatim} + \documentclass{article} + \begin{document} + Hello World! + \end{document} +\end{verbatim} +Ten mały plik korzysta jedynie z~fontu \file{cmr10}. Przyjrzyjmy się, jak +\cmdname{dvips} przygotowuje plik PostScript-owy (chcemy użyć wersji Type1 +fontu Computer Modern, stąd opcja \texttt{-Pcms}). +\begin{alltt} +> \Ucom{dvips -d4100 hello-world -Pcms -o} +\end{alltt} +Mamy tu do czynienia jednocześnie z~czwartą klasą wykrywania błędów +programu \cmdname{dvips} (ścieżki fontowe) oraz z~rozwijaniem elementu +ścieżki przez \KPS{} (patrz: \emph{Dvips Reference Manual}, +\OnCD{texmf/doc/dvips/dvips.pdf}). +Komunikaty z~uruchomienia programu (nieco zmodyfikowane) znajdują się +na~rys.~\ref{fig:dvipsdbga}. +\begin{figure*}[tp] +\centering +\input{examples/ex6a.tex} +\caption{Szukanie pliku konfiguracyjnego}\label{fig:dvipsdbga} + +\bigskip + +\input{examples/ex6b.tex} +\caption{Szukanie pliku prologu}\label{fig:dvipsdbgb} + +\bigskip + +\input{examples/ex6c.tex} +\caption{Szukanie pliku fontu}\label{fig:dvipsdbgc} +\end{figure*} + Program \cmdname{dvips} zaczyna pracę od zlokalizowania potrzebnych mu plików. +Najpierw znajduje plik \file{texmf.cnf}, który zawiera ścieżki +przeszukiwania dla innych plików. Potem znajduje bazę danych \file{ls-R} +(w~celu optymalizacji szukania plików), następnie plik \file{aliases}, +który umożliwia deklarowanie różnych nazw (np. krótkie \acro{DOS}-owe ,,8.3'' +i~bardziej naturalne dłuższe wersje) dla tych samych plików. +Następnie \cmdname{dvips} znajduje podstawowy plik konfiguracyjny +\file{config.ps}, zanim poszuka pliku z~ustawieniami użytkownika +\file{.dvipsrc} (który w~tym wypadku \emph{nie} zostaje odnaleziony). +W~końcu \cmdname{dvips} lokalizuje plik konfiguracyjny \file{config.cms} +dla fontów PostScript-owych Computer Modern (jest to inicjowane przez +dodanie parametru \texttt{-Pcms} przy uruchamianiu programu). +Plik ten zawiera listę plików z~,,mapami'', które definiują relacje +pomiędzy \TeX-owymi, PostScript-owymi i~systemowymi nazwami fontów. +\begin{alltt} +> \Ucom{more /usr/local/texmf/dvips/config/config.cms} +p +ams.map +p +cms.map +p +cmbkm.map +p +amsbkm.map +\end{alltt} +W~ten sposób \cmdname{dvips} wyszukuje wszystkie te pliki oraz główny plik +z~przemapowaniem +\file{psfonts.map}, który ładowany jest domyślnie (zawiera on deklaracje +często używanych fontów postscriptowych; więcej szczegółów na temat +postscriptowych plików przemapowań fontów można znaleźć w~ostatniej części +rozdziału \ref{SExamplesofuse}). + +W~tym miejscu \cmdname{dvips} zgłasza się użytkownikowi: +\begin{alltt}\ifSingleColumn +This is dvips 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com) +\else\small{}This is dvips 5.86 Copyright 1999 Radical Eye... +\fi\end{alltt}% decided to accept slight overrun in tub case +\ifSingleColumn +\ldots potem szuka pliku prologu \file{texc.pro}: +\begin{alltt}\small +kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0, + path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//: + ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//). +kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro +\end{alltt} +\else +potem szuka pliku prologu \file{texc.pro}. + %(patrz rys.~\ref{fig:dvipsdbgb}). + +\fi +Po znalezieniu szukanego pliku \cmdname{dvips} podaje datę i~czas +oraz informuje o~generowaniu pliku \file{hello-world.ps}. +Ponieważ potrzebuje pliku z~fontem \file{cmr10}, a~jest on +zadeklarowany jako dostępny, wyświetla komunikat: +\begin{alltt}\small +TeX output 1998.02.26:1204' -> hello-world.ps +Defining font () cmr10 at 10.0pt +Font cmr10 <CMR10> is resident. +\end{alltt} +Teraz trwa poszukiwanie pliku \file{cmr10.tfm}, który zostaje znaleziony, +po czym \cmdname{dvips} powołuje się na kilka innych plików startowych +(nie pokazanych). W~końcu przykładowy font Type1 \file{cmr10.pfb} +zostaje zlokalizowany i~dołączony do pliku wynikowego (patrz ostatnia linia): +\begin{alltt}\small +kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0, + path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//: + /var/tex/fonts/tfm//). +kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm +kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0, + ... +<texps.pro> +kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0, + path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//: + ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//). +kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb +<cmr10.pfb>[1] +\end{alltt} + +\subsection{Parametry kontrolujące działanie programów} +Inną użyteczną cechą \Webc{} jest możliwość ustalania wielu parametrów +określających wielkość pamięci za pomocą pliku \texttt{texmf.cnf}. + %Załącznik~\ref{app:texmf.cnf} zaczynający się na + %stronie~\pageref{app:texmf.cnf} zawiera listing pliku \texttt{texmf.cnf}. + Ustawienia wszystkich parametrów znajdują się w~części trzeciej pliku. +Najważniejszymi zmiennymi są: +\begin{description} +\item[\code{main\_memory}] Całkowita wielkość pamięci dostępnej dla + \TeX-a, \MF{}-a i~\MP{}-a. Dla każdego nowego ustawienia tej zmiennej + należy wykonać nowy format. + %Przykładowo, możesz wygenerować ,,ogromną'' wersję formatu \TeX{} i~nazwać + %taki plik \texttt{hugetex.fmt}. + %Dzięki standardowemu sposobowi nazywania programów przez + %\KPS{}, określona wartość zmiennej \verb|main_memory| będzie + %przeczytana z~pliku \texttt{texmf.cnf} (por. wartość standardową + %oraz wartość ,,ogromną'', wykorzystywaną przez program \texttt{hugetex}, + %itd.). + % +\item[\code{extra\_mem\_bot}] Dodatkowa wielkość pamięci przeznaczonej + na ,,duże'' struktury danych \TeX-a, takie jak: pudełka, kleje itd.; + przydatna zwłaszcza w~wypadku korzystania z~pakietu \PiCTeX{}. + % +\item[\code{font\_mem\_size}] Wielkość pamięci przeznaczonej przez + \TeX-a na informacje o~fontach. Jest to mniej więcej ogólna + wielkość wczytywanych przez \TeX-a plików TFM. + % +\item[\code{hash\_extra}] Dodatkowa wielkość pamięci przeznaczonej + na tablicę zawierającą nazwy instrukcji. Tablica główna + może zmieścić w~przybliżeniu 10000 nazw; wielkość ta może się okazać + zbyt mała, np. w~wypadku obszernej książki zawierającej liczne + odsyłacze. Domyślna wartość \texttt{hash\_extra} to \texttt{50000}. +\end{description} + % +Oczywiście powyższa możliwość nie zastąpi prawdziwej, dynamicznej +alokacji pamięci. Jest to jednak niezwykle trudne +do zaimplementowania w~obecnej wersji \TeX-a i~dlatego +powyższe parametry stanowią praktyczny kompromis, pozwalając +na pewną elastyczność. + +Należy tu jednak nadmienić, iż nie wszystkie programy korzystają +z tych zmiennych. Np. Lua\TeX\ posiada nowoczesną, +w~pełni dynamiczną alokację pamięci, a zatem powyższe zmienne są +w tym przypadku po prostu ignorowane. + +%%==== +%\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. +Nie jest to takie trudne, jak się wydaje. +Wszystko czego potrzebujemy, znajduje się na \DVD{} w~katalogu +\texttt{source}. + +Najpierw należy zainstalować główne drzewo plików \TeX-owych z~\TL{} \DVD{} +(najlepiej wykonać instalację podstawową, bez wybierania +binariów systemowych). + +\subsection{Warunki wstępne} +Do skompilowania całego \TeX-a i~jego programów pomocniczych potrzeba +około 100 megabajtów wolnego miejsca na dysku. +Potrzebny jest także kompilator \acro{ANSI}~C, oprogramowanie \cmdname{make}, +skaner leksykalny oraz generator parserów. +Programy użytkowe \acro{GNU} (\cmdname{gcc}, \acro{GNU} +\cmdname{make}, \cmdname{m4}, \cmdname{flex}, \cmdname{bison}) +są najlepiej przetestowanymi na różnych platformach. +Poprawnie powinny pracować \cmdname{gcc}-2.7.*, \cmdname{flex}-2.4.7 +i~\acro{GNU}\,\cmdname{make}-3.72.1 lub nowszy. +Można też korzystać z~innych kompilatorów C i~programów +\cmdname{make}, wymaga to jednak dobrego zrozumienia zasad tworzenia +programów uniksowych, aby poradzić sobie z~ewentualnymi problemami. + %W~wyniku wykonania polecenia \texttt{uname} powinniśmy + %otrzymać jakąś rozsądną wartość. + +\subsection{Konfiguracja} +Należy rozpakować źródła ze skompresowanego pliku \texttt{tar} +z~katalogu \dirname{source} na twardy dysk, a~potem przejść do katalogu, +do którego zostały one skopiowane. +Teraz trzeba się zdecydować, gdzie będzie główny katalog instalacji, +np.\ \path|/usr/TeX| lub \path|/usr/local/TeX|. +Naturalnie, należy użyć tej samej lokalizacji, która została użyta +podczas instalacji głównego drzewa \TeX-owego. + +Uruchomić \textsf{configure} z~linii poleceń: +\begin{alltt} +> \Ucom{./configure --prefix=/usr/local/TeX} +\end{alltt} + +Katalog ,,prefix'' to ten, w~którym zainstalowane zostało główne drzewo +\TeX-owe. Zostanie użyty następujący układ katalogów + (\verb|$TEXDIR| oznacza wybrany powyżej katalog): + +\noindent +\begin{tabular}{>{\ttfamily}ll@{}} + \dirname{$TEXDIR/man} & strony manuala uniksowego,\\ + \dirname{$TEXDIR/share/texmf} & główne drzewo \TeX-owe, + zawierające makra itp.,\\ + \dirname{$TEXDIR/info} & podręczniki w formacie \acro{GNU} + info,\\ + \dirname{$TEXDIR/bin/$PLATFORM} & binaria\\ +\end{tabular} +%$ + +Można uniknąć stosowania ,,\dirname{share/}'' przed katalogiem +\dirname{texmf}, ponieważ \dirname{$TEXDIR/share/texmf} +i~\dirname{$TEXDIR/texmf} są wykrywane automatycznie przez skrypt \cmdname{configure}. +W~razie wybrania innego katalogu, trzeba ten katalog wyszczególnić +parametrem \verb|--datadir| skryptu \cmdname{configure}. + +Jeżeli nie chcemy używać katalogu \dirname{$PLATFORM} +(a~więc umieścić binaria bezpośrednio w~\dirname{$TEXDIR/bin}), to +w~wywołaniu 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) można zobaczyć, uruchamiając +\texttt{./configure -{}-help}. + +\subsection{Uruchamianie \textsf{make}} +Po upewnieniu się, że nie jest ustawiona zmienna powłoki \texttt{noclobber}, +należy napisać: +\begin{alltt} +> \Ucom{make world} +\end{alltt} +i~\ldots zaparzyć sobie kawę. + +Może się też przydać zapisanie całego procesu +kompilacji w~pliku \texttt{.log}: +\begin{alltt} +> \Ucom{sh -c "make world >world.log 2>\&1" \&} +\end{alltt} +Zanim stwierdzimy, że wszystko jest w~porządku, warto sprawdzić, czy w~pliku +\texttt{.log} nie ma komunikatów błędów (kiedy polecenie zwraca kod błędu, +\acro{GNU} \cmdname{make} zawsze używa sekwencji \samp{***}), +i~czy utworzone zostały wszystkie binaria: +\begin{alltt} +> \Ucom{cd \var{TEXDIR}/bin/\var{archname}} +> \Ucom{ls | wc} +\end{alltt} +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}: +\begin{alltt} +> \Ucom{make all} +> \Ucom{su} +> \Ucom{make install strip} +\end{alltt} + +\subsection{Końcowe kroki konfiguracyjne} +Należy uaktualnić zmienną \envname{PATH} o~nazwę katalogu zawierającego +właśnie zainstalowane binaria (np.\ +\dirname{/usr/local/TeX/bin/mips-sgi-irix6.3}); podobnie postąpić trzeba +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}). + +Jeśli zechcesz udostępnić skompilowane przez siebie programy, skontaktuj +się z~nami (\url{tex-live@tug.org}); chętnie umieścimy je na stronie \TL. +%\end{comment} + +%-------------------------- +\htmlanchor{ack} +\section{Podziękowania} + +\TL{} jest wspólnym dziełem prawie wszystkich grup \TeX-owych. +Niniejsza edycja \TL{} została opracowana pod kierownictwem Karla Berry'ego, +przy głównym współudziale: + +\begin{itemize*} +\item grup \TeX-owych: międzynarodowej, niemieckiej, holenderskiej i~polskiej + (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} (w~szczególności Robina Fairbairnsa, Jima + Hef{}ferona i~Rainera Sch\"opfa), który dystrybuuje obrazy płyt \TL{} + i~udostępnia wspólną infrastrukturę służącą aktualizacji pakietów, od której + zależy \TL{}; +\item Nelsona Beebe, za umożliwienie dostępu do wielu platform ekipie \TL\ + i pomoc w testowaniu; +\item Johna Bowmana, który dostosował swój zaawansowany program Asymptote + do współpracy z 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 Jin-Hwan Cho i całego zespołu DVIPDFM$x$ za ten znakomity sterownik + i nieustanną pomoc w~rozwiązywaniu problemów z konfiguracją; +\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 doskonalenie 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 dostarczał poprawki; + Eitan zmarł w czerwcu 2009~r. i dedykujemy tę dokumentację Jego pamięci; +\item Hansa Hagena, który dostosowywał \ConTeXt\ do potrzeb \TL; +\item \Thanh{}a, Martina Schr\"odera i~zespołu pdf\TeX-a, którzy ciągle + ulepszali możliwości \TeX-a; +\item Hartmuta Henkela, mającego istotny udział w~rozwoju pdf\TeX-a, + Lua\TeX-a i~innych programów; +\item Taco Hoekwatera, który wznowił rozwój MetaPosta i~pracował nad + Lua\TeX-em, jak też pomógł w~integracji \ConTeXt\ w~\TL oraz + ulepszył bibliotekę Kpathsea, dodając jej wielowątkowość; +\item Pawła Jackowskiego, który wykonał instalator dla Windows \cmdname{tlpm} + i~Tomka Łuczaka, twórcy \cmdname{tlpmgui} (programy te były wykorzystane + w~poprzednich edycjach); +\item Akira Kakuto, który dostarczył programy dla Windows, pochodzące + z~dystrybucji \acro{W32TEX} + (\url{http://w32tex.org}), + stale dostosowywane i~aktualizowane dla potrzeb \TL; +\item Jonathana Kew, który zainicjował nową ścieżkę + rozwojową -- Xe\TeX{}, i~który włożył sporo wysiłku w~zintegrowanie + tego programu z~\TL, jak również zapoczątkował prace nad instalatorem dla + Mac\TeX{} oraz edytorem \TeX{}works; +\item Dicka Kocha, który pielęgnuje Mac\TeX-a (\url{http://tug.org/mactex}) + w~ścisłym połączeniu z~\TL i~bardzo sympatycznie współpracuje; +\item Reinharda Kotuchy, mającego istotny udział w~stworzeniu nowej infrastruktury + i~programu instalacyjnego dla \TL{} 2009, uparcie dążącego do ujednolicenia + działania \TL{} w~Windows i~Unix, który również opracował skrypt + \texttt{getnonfreefonts} i~wykonał wiele innych prac; +\item Siep Kroonenberg, która również wzięła udział w~stworzeniu nowej + infrastruktury i~programu instalacyjnego dla \TL{} 2009 (szczególnie dla + Windows) oraz włożyła sporo pracy w aktualizację tej dokumentacji; +\item Petra Ol\shac{}\aac{}ka, który koordynował i~sprawdzał + przygotowanie pakietów czeskich i~słowackich; +\item Toshio Oshimy, który opracował przeglądarkę \cmdname{dviout} dla Windows; +\item Manuela P\'egouri\'e-Gonnarda, który pomógł w~aktualizacji pakietów + i~pracował nad \cmdname{texdoc}; +\item Fabrice'a Popineau, który pierwszy stworzył wersje oprogramowania + dla Windows; +\item Norberta Preininga, głównego architekta infrastruktury i~programu + instalacyjnego \TL{} 2009, który przyczynił się również do aktualizacji + pakietów, a także koordynował (wraz z~Frankiem K\"usterem) debianową + wersję \TL{} i~przedstawił wiele sugestii ulepszeń; +\item Sebastiana Rahtza, który stworzył \TL{} i~kierował projektem przez + wiele lat; +\item Phila Taylora, który skonfigurował BitTorrent + (do pobierania plików z sieci) na potrzeby \TL{}; +\item Tomka Trzeciaka, który pracowicie rozwiązywał rozliczne problemy + związane z Windows; +\item Vladimira Volovicha, który wydatnie pomógł w~rozwiązywaniu problemów + przenośności, szczególnie zaś umożliwił 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); +\item Olafa Webera, który cierpliwie pielęgnował Web2C, od którego wszystko zależy; +\item Gerbena Wierda, który przygotował oryginalne oprogramowanie i~wsparcie + dla \MacOSX{}; +\item Grahama Williamsa, którego prace nad katalogiem pakietów bardzo + pomogły w~przygotowaniu dystrybucji. +\end{itemize*} + +Binaria dla różnych platform skompilowali: +Ettore Aldrovandi (\pkgname{i386-solaris}, \pkgname{x86\_64-solaris}), +Alan Braslau (\pkgname{amd64-kfreebsd}, \pkgname{i386-kfreebsd}), +Peter Breitenlohner (\pkgname{x86\_64-linux}), +Karl Berry (\pkgname{i386-linux}), +Ken Brown (\pkgname{i386-cygwin}), +Akira Kakuto (\pkgname{win32}), +Dick Koch (\pkgname{universal-darwin}, \pkgname{x86\_64-darwin}), +Nikola Le\v{c}i\'c (\pkgname{amd64-freebsd}, \pkgname{i386-freebsd}), +Mojca Miklavec (\pkgname{mipsel-linux}), +Norbert Preining (\pkgname{alpha-linux}), + %Jukka Salmi (\pkgname{i386-netbsd}), + Thomas Schmitz (\pkgname{powerpc-linux}), +Boris Veytsman (\pkgname{armel-linux}), +Vladimir Volovich (\pkgname{powerpc-aix}, \pkgname{sparc-solaris}), +Olaf Weber (\pkgname{mips-irix}). +Informacje na temat procesu budowy \TL{} można znaleźć na stronie: +\url{http://tug.org/texlive/build.html}. + +Aktualizacje i~tłumaczenia dokumentacji wykonali: +Siep Kroonenberg i~Karl Berry (angielski), +Manuel P\'egouri\'e-Gonnard (francuski), +Uwe Ziegenhagen (niemiecki), +Jjgod Jiang, Jinsong Zhao, Yue Wang i~Helin Gai (chiński), +Marco Pallante (włoski), +Nikola Le\v{c}i\'c (serbski), +Petr Sojka i~Jan Busa (czeski\slash słowacki), +Boris Veytsman (rosyjski), +Staszek Wawrykiewicz (polski). +Na stronie \url{http://tug.org/texlive/doc.html} będą umieszczane ewentualne +aktualizacje tej dokumentacji. + +Oczywiście, najważniejsze podziękowania należą się Donaldowi Knuthowi +za stworzenie systemu \TeX{} i~ofiarowanie go nam wszystkim. + +%%% +\section{Historia} +\label{sec:history} + +\subsection{Poprzednie wersje} + +Dystrybucja \TL{} jest wspólnym przedsięwzięciem +grup Użytkowników Systemu \TeX{} z Niemiec, Holandii, Wielkiej +Brytanii, Francji, Czech, Słowacji, Polski, Indii i~Rosji oraz grupy +międzynarodowej TUG (\emph{\TeX{} Users Group}). +Dyskusje nad projektem rozpoczęły się pod koniec 1993 roku, kiedy holenderska +Grupa Użytkowników \TeX-a rozpoczęła prace nad swoim +4All\TeX{} \CD{} dla użytkowników \acro{MS-DOS}. W~tym też +czasie pojawiły się nadzieje na opracowanie jednego \CD{} dla +wszystkich systemów. +Projekt ten był wprawdzie zbyt ambitny, zrodził jednak nie tylko bardzo +popularny i~uwieńczony dużym powodzeniem projekt 4All\TeX{} \CD{}, +lecz również spowodował powstanie Grupy Roboczej TUG ds. Standardu Katalogów +\TeX-owych (\emph{\TeX{} Directory Structure}), określającego, w~jaki +sposób tworzyć zgodne i~łatwe do zarządzania zestawy pakietów \TeX-owych. +Końcowy raport \TDS{} został opublikowany w~grudniowym numerze +\textsl{TUGboat}-a, i~jasnym się stało, że +jednym z~oczekiwanych wyników wprowadzenia tego standardu mogłaby +być modelowa struktura na płytce \CD. +Wydana wówczas płytka \CD{} była bezpośrednim rezultatem rozważań i~zaleceń +Grupy Roboczej ds. \TDS. +Jasne także było, że sukces 4All\TeX{} \CD{} pokazał, że +użytkownicy Unixa także wiele by zyskali, mogąc korzystać +z~podobnie łatwego w~instalacji/pielęgnacji i~użytkowaniu systemu. +Było to jednym z~celów projektu \TL. + +Projekt przygotowania płytki \CD, opartej na standardzie \TDS i~zorientowanej +na systemy uniksowe, rozpoczął się jesienią 1995 roku. Szybko +zdecydowaliśmy się na wykorzystanie \teTeX-a autorstwa Thomasa Essera, ponieważ +działał na wielu platformach i~został zaprojektowany z~myślą +o~przenośności pomiędzy różnymi systemami plików. Thomas zgodził się pomóc +i~prace rozpoczęły się na dobre na początku 1996 roku. Pierwsze wydanie +ukazało się w~maju 1996 roku. Na początku 1997 roku Karl Berry udostępnił +nową, istotnie zmienioną wersję swojego pakietu \Webc, zawierającą prawie +wszystkie funkcje wprowadzone do \teTeX-a przez Thomasa Essera. W~związku +z~tym zdecydowaliśmy się oprzeć drugie wydanie \CD{} na standardowej +bibliotece \Webc, z~dodaniem skryptu \texttt{texconfig} z~pakietu \teTeX. +Trzecie wydanie \CD{} było oparte na \Webc{} wersji 7.2, przygotowanej przez +Olafa Webera. W~tym samym czasie została przygotowana nowa wersja \teTeX-a +i~\TL{} udostępniał prawie wszystkie jego nowe funkcje. +Czwarta edycja była przygotowana podobnie, +z~użyciem nowej wersji te\TeX-a i~nowej wersji \Webc{} (7.3). +Wtedy to też zapoczątkowano kompletną dystrybucję dla Windows. + +Edycja piąta (marzec 2000) zawierała wiele poprawek i~uzupełnień; +zaktualizowano setki pakietów. Szczegółową zawartość pakietów +zapisano w~plikach XML. +Główną zmianą w~\TeX\ Live~5 było usunięcie programów, które nie miały +statusu {\it public domain}. Zawartość całej płytki powinna odpowiadać ustaleniom +Debian Free Software Guidelines (\url{http://www.debian.org/intro/free}). +Dołożyliśmy wszelkich starań, aby sprawdzić warunki licencyjne pakietów. + %nadal jednak bardzo prosimy o~zgłaszanie zauważonych pomyłek. + +Szósta edycja (lipiec 2001) zawierała aktualizacje całego materiału. Główną +zmianą było wprowadzenie nowej koncepcji programów instalacyjnych -- użytkownik +miał odtąd możliwość dokładniejszego wyboru potrzebnych zestawów i~pakietów. +Zestawy dotyczące obsługi poszczególnych języków zostały całkowicie +zreorganizowane, dzięki czemu wybór jednego z~nich nie tylko instalował +potrzebne makra i~fonty, ale też przygotowywał odpowiedni plik +\texttt{language.dat}. + +\TL~7 (rok 2002) zawierał po raz pierwszy oprogramowanie dla \MacOSX{} +i -- jak zwykle -- aktualizację wszelkich programów i~pakietów. +Ważnym zadaniem, które wykonano, było ujednolicenie plików źródłowych +programów z~dystrybucją te\TeX. W~programach instalacyjnych wprowadzono +możliwość wyboru bardziej ogólnych, predefiniowanych zestawów pakietów +(m.in. dla użytkowników francuskojęzycznych oraz polskich). Nowością +było także wprowadzenie procedury aktualizacji map fontowych dla Dvips +i~PDFTeX podczas instalacji oraz doinstalowywania pakietów fontowych. + +W~2003~r., wraz z~napływem aktualizacji i~dodatkowych nowych pakietów, +okazało się, że \TL{} nie mieści się na pojedynczym \CD. +Zmuszeni byliśmy podzielić \TL{} na trzy dystrybucje, które wydano +na \DVD{} i~dwóch płytkach \CD. Ponadto: + +\begin{itemize*} +\item na życzenie ,,\LaTeX{} team'' zmieniono standardowe użycie + programów \cmdname{latex} i~\cmdname{pdflatex}~-- by korzystały + one z~\eTeX{} (patrz str.~\pageref{text:etex}); +\item załączono nowe fonty obwiedniowe Latin Modern, które zastępują + m.in. fonty EC (zawierając komplet znaków europejskich), szczególnie + do tworzenia poprawnych plików PDF; +\item usunięto binaria dla platformy Alpha \acro{OSF} (poprzednio + usunięto także binaria dla \acro{HPUX}), niestety nie udało się znaleźć + osób chętnych do wykonania kompilacji; +\item zmieniono instalację w~systemach Windows, wprowadzając po raz pierwszy + zintegrowane środowisko pracy, oparte na edytorze XEmacs; +\item potrzebne programy pomocnicze dla Windows (Perl, Ghost\-script, + Image\-Magick, Ispell) instalowano w~strukturze katalogów + instalacji \TL; +\item mapy fontowe, z~których korzystają programy \cmdname{dvips}, + \cmdname{dvipdfm} oraz \cmdname{pdftex}, generowano odtąd w~katalogu + \dirname{texmf/fonts/map}; +\item \TeX{}, \MF{} oraz \MP{} domyślnie pozwalały wypisywać komunikaty + na ekranie i~w~pliku .log, a~także w~operacjach \verb|\write| w~ich + reprezentacji 8-bitowej, zamiast tradycyjnej notacji \verb|^^|; + w~\TL{}~7 eksperymentalnie wprowadzono zależność przekodowania + wyjścia programów od systemowej strony kodowej, potem ten pomysł + zarzucono; +\item znacznie zmieniono niniejszą dokumentację; +\item wreszcie, ponieważ numery wersji kolejnych edycji mogły wprowadzać + w~błąd, postanowiono identyfikować edycje \TL{} zgodnie z~rokiem + wydania. +\end{itemize*} + +\subsection{Wydanie 2004} + +Jak w~każdej kolejnej wersji, w~2004 roku uaktualniono wiele pakietów +i~programów. Poniżej wymieniamy najbardziej istotne zmiany. + +\begin{itemize} +\item Gdy mieliśmy już lokalnie zainstalowane fonty, które korzystały +z~własnych plików \filename{.map} i/lub \filename{.enc}, \emph{należało} +przenieść te pliki w~nowe miejsce w~strukturze \filename{texmf/}. + +Pliki \filename{.map} (map fontowych) są odtąd wyszukiwane w~podkatalogach +\dirname{fonts/map} (w~każdym drzewie \filename{texmf}), zgodnie ze ścieżką +określoną przez zmienną \envname{TEXFONTMAPS}. Analogicznie, pliki +\filename{.enc} (przekodowań fontów) są odtąd wyszukiwane w~podkatalogach +\dirname{fonts/enc}, zgodnie ze ścieżką określoną przez zmienną +\envname{ENCFONTS}. O~niewłaściwie umieszczonych plikach tego typu +zostaniemy ostrzeżeni podczas uruchomienia programu \cmdname{updmap}. +Zmiany te wprowadzono w~celu uporządkowania struktury katalogów: wszystkie +pliki dotyczące fontów znajdują się odtąd w~ramach jednego podkatalogu +\dirname{fonts/}. + +Metody radzenia sobie z~sytuacjami związanymi z~przejściem na nowy układ +katalogów omawiał artykuł \url{http://tug.org/texlive/mapenc.html}. + +\item Do \TK\ \DVD{} dodano nową dystrybucję dla Windows o~nazwie +pro\TeX{}t (opartą na \MIKTEX-u). Była ona dostępna także na odrębnym \CD. +Choć pro\TeX{}t nie bazuje na implementacji Web2C, stosuje układ katalogów +zgodny z~\TDS (patrz część~\ref{sec:struct-tl} na +str.~\pageref{sec:struct-tl}). + +\item W ramach \TL{} dotychczasowe pojedyncze drzewo katalogów +\dirname{texmf} zostało rozdzielone na trzy mniejsze: \dirname{texmf}, +\dirname{texmf-dist} i~\dirname{texmf-doc} (patrz +część~\ref{sec:tld}, str.~\pageref{sec:tld}) oraz pliki \filename{README} +w~każdym z~tych katalogów). + +\item Wszystkie pliki makr wczytywane przez \TeX-a zostały +umieszczone wyłącznie w~podkalogu \dirname{tex} w~ramach +\dirname{texmf*}. Tym samym usunięto zbędne katalogi +\dirname{etex}, \dirname{pdftex}, \dirname{pdfetex} itp. i~uproszczono +metody wyszukiwania plików. Patrz +\CDref{texmf-dist/doc/generic/tds/tds.html\#Extensions} +{\texttt{texmf-dist/doc/generic/tds/tds.html\#Extensions}}. + +\item Pomocnicze skrypty wykonywalne, niezależne od platformy +i~zwykle uruchamiane w~sposób automatyczny, były odtąd +umieszczone w~nowym podkatalogu \dirname{scripts} w~ramach \dirname{texmf*}. +Znajdowane są poleceniem \verb|kpsewhich -format=texmfscripts|. +Programy korzystające z tych skryptów mogły wymagać modyfikacji. +Patrz \CDref{texmf-dist/doc/generic/tds/tds.html\#Scripts} +{\texttt{texmf-dist/doc/generic/tds/tds.html\#Scripts}}. + +\item Prawie wszystkie formaty traktują od tego wydania większość znaków jako +jawnie ,,wyświetlalne'' (\emph{printable}), nie zaś, jak było dotychczas, +konwertowane na \TeX-ową notację \verb|^^|. Było to możliwe dzięki domyślnemu +wczytywaniu tablicy przekodowań \filename{cp227.tcx}. Dokładniej, znaki +o~kodach 32--256, HT, VT oraz FF zostały potraktowane dosłownie podczas +wyświetlania komunikatów. Wyjątkiem jest plain \TeX{} (tylko znaki z~zakresu +32--127 są nie zmieniane), \ConTeXt{} (znaki z zakresu 0--255) oraz formaty +bazujące na Omedze. Podobna domyślna właściwość występowała w~\TL\,2003, ale +w~tej edycji została zaimplementowana w~bardziej elegancki sposób +i~z~większymi możliwościami indywidualnego dostosowania (patrz +\CDref{texmf/doc/web2c/web2c.html\#TCX-files} {\texttt{texmf/doc/web2c/web2c. +tml\#TCX-files}}. (Warto wspomnieć, że wczytując Unicode, \TeX{} może +w~komunikatach błędów pokazywać niekompletne sekwencje znaków, ponieważ +został zaprojektowany ,,bajtowo''.) + %%! hmmm, cały akapit by o strumieniach we-wy? + +\item Program \textsf{pdfetex} został domyślną ,,maszyną'' dla +większości formatów (nie dotyczy to samego Plain \textsf{tex}). +Domyślnie, gdy uruchamiamy polecenie \textsf{latex}, \textsf{mex} +itp., generowane są pliki \acro{DVI}. Możliwe jest jednak wykorzystanie +w~\LaTeX, \ConTeXt{} itp. m.in. właściwości mikrotypograficznych +zaimplementowanych w~\textsf{pdftex}, a~także rozszerzonych cech \eTeX-a +(\OnCD{texmf-dist/doc/etex/base/}). + +Oznacza to także, co warto podkreślić, że \emph{zalecane} jest odtąd użycie +pakietu \pkgname{ifpdf} (który działa zarówno z~plain, jak i~\LaTeX) +lub analogicznych makr. Zwykłe sprawdzanie czy zdefiniowano \cs{pdfoutput} +bądź kilka innych poleceń pierwotnych może nie wystarczyć do rozstrzygnięcia +czy nie jest generowany plik \acro{PDF}. W~2004 roku podjęliśmy +wysiłek by zachować, najlepiej jak to możliwe, kompatybilność +z~dotychczasowymi przyzwyczajeniami użytkowników. Brano wówczas pod uwagę, +że \cs{pdfoutput} może być zdefiniowany nawet wtedy, +gdy generowany jest plik \acro{DVI}. + +\item pdf\TeX\ (\url{http://pdftex.org}) zyskał wówczas wiele nowych +cech: + + \begin{itemize*} + \item \cs{pdfmapfile} i~\cs{pdfmapline} pozwalają określić + z~poziomu dokumentu użyte mapy fontowe, a~także pojedyncze + dodatkowe wpisy w~tych mapach. + + \item mikrotypograficzne operacje z~fontami są łatwiejsze w użyciu;\\ + \url{http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html} + + \item wszystkie parametry pracy pdf\TeX-a, dotychczas określane + w~specjalnym pliku konfiguracyjnym \filename{pdftex.cfg}, muszą być + odtąd ustawiane poleceniami wbudowanymi, jak w~pliku + \filename{pdftexconfig.tex}; plik \filename{pdftex.cfg} + nie jest już w~ogóle wykorzystywany. Po zmianie \filename{pdftexconfig.tex} + należało na nowo wygenerować pliki formatów (wciąż jednak użytkownik miał + pełną swobodę określania parametrów w~redagowanym dokumencie); + + \item więcej informacji zawarto w~podręczniku pdf\TeX-a: + \OnCD{texmf-dist/doc/pdftex/manual/pdftex-a.pdf}. + + \end{itemize*} + +\item Polecenie \cs{input} w~programach \cmdname{tex}, + \cmdname{mf} oraz \cmdname{mpost} akceptowało odtąd nazwy + plików ograniczone podwójnymi apostrofami, zawierające spacje i~inne + znaki, np.: +\begin{verbatim} +\input "nazwa_pliku ze spacjami" % plain +\input{"nazwa_pliku ze spacjami"} % latex +\end{verbatim} +Więcej informacji zawarto w~podręczniku Web2C: \OnCD{texmf/doc/web2c}. + +\item \texttt{-output-directory} -- nowa opcja programów \cmdname{tex}, + \cmdname{mf} oraz \cmdname{mpost} -- pozwalała na zapisanie wyniku pracy + w~wyspecyfikowanym katalogu (np. można uruchomić program \texttt{tex} + z~plikiem znajdującym się na dysku tylko do odczytu, zaś wynik zapisać + na dysku pozwalającym na~to); + +\item Rozszerzenie enc\TeX\ zostało szczęśliwie włączone do Web2C. + Aby uaktywnić to rozszerzenie, należało podczas generowania formatu + użyć opcji \optname{-enc}. Ogólnie mówiąc, enc\TeX\ obsługuje + przekodowanie wejścia i~wyjścia, włączając także Unicode (\acro{UTF}-8) + (patrz \OnCD{texmf-dist/doc/generic/enctex/} oraz + \url{http://www.olsak.net/enctex.html}). + +\item Udostępniono nowy program Aleph, który łączył cechy \eTeX\ i~\OMEGA. + Skromna dokumentacja jest dostępna na \OnCD{texmf-dist/doc/aleph/base} + oraz \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph}. + Format oparty na \LaTeX-u dla programu Aleph nazwano \textsf{lamed}. + +\item Dystrybucja \LaTeX-a została po raz pierwszy zaopatrzona w~nową + licencję \acro{LPPL}, odtąd w~pełni zgodną i~aprobowaną przez zalecenia + określone w~licencji Debiana. O~nowościach i~uaktualnieniach można się + dowiedzieć przeglądając pliki \filename{ltnews} + w~\OnCD{texmf-dist/doc/latex/base}. + +\item Dołączono także program \cmdname{dvipng} konwertujący pliki \acro{DVI} +do formatu graficznego \acro{PNG} (\OnCD{texmf/doc/man/man1/dvipng.1}). + +\item W~porozumieniu i~z~pomocą autora, Claudio Beccariego, ograniczono + pakiet \pkgname{cbgreek} do zestawu fontów rozsądnego rozmiaru. Usunięto + sporadycznie używane fonty konturowe i~służące do prezentacji. Pełen + zestaw jest oczywiście nadal dostępny z~serwerów \acro{CTAN} +(\url{http://mirror.ctan.org/tex-archive/fonts/greek/cb}). + +\item Usunięto program \cmdname{oxdvi}; jego funkcje przejął + \cmdname{xdvi}. + +\item Programy z~przedrostkiem \cmdname{ini} oraz \cmdname{vir} + (np. \cmdname{initex}), które zwykle były dowiązaniami do programów + \cmdname{tex}, \cmdname{mf} i~\cmdname{mpost}, nie były od tej pory dostępne + -- w~zupełności wystarcza użycie w~wierszu poleceń opcji \optname{-ini}. + +\item Dystrybucja nie zawierała binariów dla platformy \textsf{i386-openbsd} + (głównie z~powodu braku chętnych do wykonania kompilacji). + +\item W~systemie \textsf{sparc-solaris} należało ustawić zmienną systemową + \envname{LD\_LIBRARY\_PATH}, aby uruchomić programy \pkgname{t1utils}. + Binaria były kompilowane w~C++, ale w~tym systemie brakowało standardowego + położenia bibliotek uruchomieniowych. Wiedziano o~tym już wcześniej, + nie było to jednak dotychczas udokumentowane. Z~kolei dla systemu + \textsf{mips-irix} wymagana była obecność bibliotek \acro{MIPS}pro 7.4. + +\end{itemize} + +\subsection{Wydanie 2005} + +Kolejna edycja przyniosła, jak zwykle, mnóstwo aktualizacji pakietów +i~programów. Struktura dystrybucji ustabilizowała się, niemniej +pojawiło się nieco zmian w~konfiguracji: + +\begin{itemize} + +\item Wprowadzono nowe skrypty \cmdname{texconfig-sys}, \cmdname{updmap-sys} + i~\cmdname{fmtutil-sys}, których zadaniem jest modyfikowanie plików + konfiguracyjnych w~głównych drzewach katalogów systemu. Dotychczasowe + skrypty \cmdname{texconfig}, \cmdname{updmap} i~\cmdname{fmtutil} + modyfikują odtąd pliki użytkownika w~katalogu \dirname{$HOME/.texlive2005}. + %(Patrz część~\ref{sec:texconfig}, str.~\pageref{sec:texconfig}). + +\item Dodano nowe zmienne środowiskowe \envname{TEXMFCONFIG} + i~\envname{TEXMFSYSCONFIG}, które wskazują położenie drzew katalogów + z~plikami konfiguracyjnymi, odpowiednio: użytkownika i~systemu. Tak więc + mogło okazać się koniecznym przeniesienie własnych wersji + \filename{fmtutil.cnf} i~\filename{updmap.cfg} w~odpowiednie miejsca. + Inną możliwością było przedefiniowanie \envname{TEXMFCONFIG} lub + \envname{TEXMFSYSCONFIG} w~pliku \file{texmf.cnf}. W~każdym z~przypadków + położenie tych plików i~przypisania + \envname{TEXMFCONFIG} i~\envname{TEXMFSYSCONFIG} muszą być zgodne. + (Patrz część~\ref{sec:texmftrees}, str.~\pageref{sec:texmftrees}.) + +\item W~wydaniu z~poprzedniego roku podczas tworzenia wynikowego pliku + DVI \verb|\pdfoutput| i~podobne polecenia pozostawały niezdefiniowane, mimo + że używany był program \cmdname{pdfetex}. Zgodnie z~obietnicą, + w~2005 roku zarzucono to rozwiązanie (jego celem było zapewnienie + kompatybilności). Z~tego powodu użytkownik był zmuszony zmienić te dokumenty, + które używały \verb|\ifx\pdfoutput\undefined| do sprawdzania, czy plik + wynikowy ma być w~formacie PDF. Zamiast tego należało zastosować pakiet + \pkgname{ifpdf.sty}, 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 z~2004 roku zmieniono większość formatów tak, by + 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.: + +\begin{verbatim} +latex --translate-file=empty.tcx twojplik.tex +\end{verbatim} + +\item Dołączono nowy program \cmdname{dvipdfmx}, służący do konwersji DVI + do PDF. Program jest aktywnie pielęgnowaną wersją programu + \cmdname{dvipdfm}, który wciąż jest dostępny, ale nie jest już jednak + polecany. + +\item Nowe programy \cmdname{pdfopen} i~\cmdname{pdfclose} pozwalały na + przeładowanie plików PDF w~Adobe Acrobat Reader, bez konieczności ponownego + uruchamiania programu. (Inne przeglądarki formatu PDF, jak \cmdname{xpdf}, + \cmdname{gv} i~\cmdname{gsview}, nigdy na tę przypadłość nie cierpiały.) + +\item Dla spójności, zmienne \envname{HOMETEXMF} i~\envname{VARTEXMF} zostały + przemianowane odpowiednio na \envname{TEXMFHOME} i~\envname{TEXMFSYSVAR}. + Zachowano zmienną \envname{TEXMFVAR}, przeznaczoną domyślnie dla + użytkownika. Patrz też punkt pierwszy, powyżej. + +\end{itemize} + +\subsection{Wydanie 2006--2007} + +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}. + +W istotny sposób został zaktualizowany MetaPost, zaplanowano także jego +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ą 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) od tej edycji już nie analizował pierwszego +wiersza rozpoczynającego się znakami \texttt{\%\&}, aby ustalić jaki ma +wczytać format. Pozostał zatem czysty, Knuthowy \TeX. \LaTeX\ i~wszystkie +pozostałe formaty nadal analizują pierwszy wiersz z~\texttt{\%\&}. + +Oczywiście, jak zwykle, w~okresie od poprzedniego wydania opracowano setki +innych aktualizacji pakietów i programów. Kolejne aktualizacje można znaleźć +tradycyjnie na \acro{CTAN} (\url{http://mirror.ctan.org}). + +Drzewo źródłowe \TL{} jest odtąd przechowywane w~Subversion. Przeglądanie +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 w~nadchodzących latach będzie to stabilne repozytorium oprogramowania +dla rozwoju \TL{}. + +W~maju 2006~r. Thomas Esser ogłosił, że zaprzestaje aktualizowania +dystrybucji te\TeX{} (\url{http://tug.org/tetex}). Spowodowało to znaczny +wzrost zainteresowanie \TL, szczególnie wśród dystrybutorów +\acro{GNU}/Linuksa. (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 skorzystają wszyscy. + +\subsection{Wydanie 2008} + +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. + +Obsługa dla Windows i~platform opartych na Unix została obecnie znacznie +bardziej zunifikowana. W~szczególności większość skryptów w~Perlu 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} +uzyskania 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 sposobem na polonizację +dla \LaTeX-a. + +Usunięto pliki \filename{.pool}, które są obecnie wkompilowane w~programy, +co ułatwia ich aktualizację. + +Do tego wydania włączono także ostatnie zmiany dokonane przez +Donalda Knutha (tzw. \textit{\TeX\ tuneup of 2008}); patrz: +\url{http://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf}. + +\subsection{Wydanie 2009} + +W wydaniu 2009 najbardziej widoczną zmianą jest to, że +pdf\AllTeX\ \emph{automatycznie} dokonuje konwersji pliku EPS do PDF, +poprzez uruchomienie programu \code{epstopdf} (dotyczy to sytuacji, +gdy użyto pliku konfiguracyjnego \code{graphics.cfg} \LaTeX-a i gdy +plikiem wynikowym składu ma być PDF). Domyślne ustawienia zapobiegają +nadpisaniu wszelkich utworzonych wcześniej przez użytkownika plików PDF, +ale można także wyłączyć uruchamianie \code{epstopdf}, wstawiając +|\newcommand{\DoNotLoadEpstopdf}{}| (lub |\def...|) przed deklaracją +\cs{documentclass}. Szczegóły można znaleźć w dokumentacji pakietu epstopdf +(\url{http://ctan.org/pkg/epstopdf-pkg}). + +Ważną zmianą jest także uruchamianie podczas kompilacji niektórych +zewnętrznych programów via \cs{write18}. Dotyczy to np. +\code{epstopdf}, \code{makeindex} czy \code{bibtex}. Dokładna lista +takich programów zawarta jest w pliku \code{texmf.cnf}. +Dla instalacji, które mogą wymagać zakazu uruchamiania takich programów +,,w~tle'' przewidziano odpowiednią opcję w programie instalacyjnym (patrz +część~~\ref{sec:options}). Po instalacji można zablokować uruchamianie +w~pliku \code{texmf.cnf}. + +Od wydania 2009 domyślnym formatem wyjściowym dla Lua\AllTeX\ staje się PDF +(wykorzystuje on m.in. obsługę przez Lua\-\TeX-a fontów OpenType). Aby uzyskać +plik DVI należy użyć nowych poleceń: \code{dviluatex} lub \code{dvilualatex}. +Strona domowa projektu Lua\TeX: \url{http://luatex.org}. + +Usunięto oryginalny silnik Omega i format Lambda (w uzgodnieniu z autorami). +Pozostał zaktualizowany Aleph i format Lamed, oraz pliki pomocnicze Omega. + +Załączono nowe wydanie fontów AMS \TypeI, m.in. fonty +Computer Modern. Zawierają one poprawki dokonane w plikach metafontowych +przez D.~Knutha w ciągu ostatnich lat, a także poprawki hintingu. +Hermann Zapf przeprojektował także fonty Euler (patrz +\url{http://tug.org/TUGboat/Articles/tb29-2/tb92hagen-euler.pdf}). +Co ważne, dla wszystkich fontów nie zmieniono plików metrycznych (TFM). +Strona domowa fontów: \url{http://www.ams.org/tex/amsfonts.html}. + +Dla Windows i Mac\TeX{} dołączono nowe środowisko\dywiz edytor \TeX{}works. +Dla innych platform patrz: \url{http://tug.org/texworks}. +Inspirowany przez edytor TeXShop dla \MacOSX, \TeX{}works jest +wieloplatformowym, łatwym w użyciu środowiskiem pracy. + +Dla niektórych platform załączono nowy program graficzny Asymptote +(\url{http://asymptote.sourceforge.net}). Korzysta on z tekstowej notacji +zbliżonej do MetaPosta, ale rozszerzonej do obsługi 3D itp. + +Program \code{dvipdfm} został zastąpiony przez \code{dvipdfmx}, który +działa w specjalnym trybie kompatybilnym, gdy użyć do wywołania +dawną nazwę. \code{dvipdfmx} wspiera \acro{CJK} i zawiera wiele poprawek +od ostatniej dystrybucji \code{dvipdfm}. Strona domowa: +\url{http://project.ktug.or.kr/dvipdfmx}. + +Dodano zestawy programów dla \pkgname{cygwin} i \pkgname{i386-netbsd}, +podczas gdy usunięto programy dla innych platform BSD. Zapewniono nas, +że użytkownicy OpenBSD i FreeBSD będą mogli pobierać pakiety \TeX-owe +wraz z aktualizacją obu systemów. Ponadto natknęliśmy się na spore trudności +przy kompilacji programów, które mogłyby działać w różnych wersjach tych +systemów. + +Inne zmiany: do kompresji pakietów użyto programu \pkgname{xz}, +stanowiącego stabilny zamiennik \pkgname{lzma} +(\url{http://tukaani.org/xz/}); znak |$| jest obecnie dozwolony w nazwach +plików, o ile nie poprzedza on nazwy znanej zmiennej; biblioteka Kpathsea +jest obecnie wielowątkowa (co wykorzystano w~programie MetaPost); do budowy +wszystkich programów wykorzystano teraz Automake. + +\subsection{Wydanie 2010} +\label{sec:2010news} % keep with 2010 + +Od wydania 2010 generowane są pliki PDF w~wersji 1.5, oferującej lepszą +kompresję. Dotyczy to wszystkich mechanizmów używanych do generowania PDF, +w~tym \code{dvipdfmx}. Powrót do wersji 1.4 jest możliwy poprzez użycie +pakietu \pkgname{pdf14} lub komendy |\pdfminorversion=4|. + +Obecnie pdf\AllTeX\ \emph{automatycznie} konwertuje plik EPS +(\textit{Encapsulated PostScript}) do formatu PDF, wykorzystując pakiet +\pkgname{epstopdf}, o~ile załadowano \LaTeX-owy plik konfiguracyjny +\code{graphics.cfg} i~wybrano format wyjściowy PDF. Domyślne ustawienia mają +na celu wykluczenie przypadkowego nadpisania istniejących już, wygenerowanych +innym sposobem plików PDF, ale można również zabronić uruchamiania +\code{epstopdf} wpisując przed poleceniem \cs{documentclass} polecenie +|\newcommand{\DoNotLoadEpstopdf}{}| (lub |\def...|). Program \code{epstopdf} nie jest +również używany w~przypadku dołączenia pakietu \pkgname{pst-pdf}. Więcej +szczegółów znajduje się w dokumentacji pakietu epstopdf +(\url{http://ctan.org/pkg/epstopdf-pkg}). + +Domyślnie włączono również wykonywanie kilku programów zewnętrznych dla \TeX-a +poprzez mechanizm \cs{write18}. Dotyczy to: \code{repstopdf}, +\code{makeindex}, \code{kpsewhich}, \code{bibtex} i~\code{bibtex8} (lista +jest zdefiniowana w~\code{texmf.cnf}). W~środowiskach, w~których wykonywanie +zewnętrznych programów jest niepożądane, należy tę opcję zaznaczyć podczas +instalacji (patrz: część~\ref{sec:options}) lub wyłączyć już po niej poprzez +uruchomienie: |tlmgr conf texmf shell_escape 0|. + +Kolejna zmiana dotyczyła programów \BibTeX\ i~Makeindex, które (podobnie +zresztą jak sam \TeX) domyślnie nie zapisują swoich plików wynikowych do +dowolnie zdefiniowanego katalogu. Umożliwia to w~ograniczonym zakresie +zadziałanie polecenia \cs{write18}. Aby to zmienić, należy ustawić zmienną +\envname{TEXMFOUTPUT} lub zmodyfikować |openout_any|. + +Podobnie jak pdf\TeX, obecnie również \XeTeX\ obsługuje wyrównywanie (tzw. +kernowanie) na krawędzi wiersza, ale możliwość poszerzania pisma +(\textit{font expansion}) nadal nie jest dostępna. + +Program tlmgr podczas aktualizacji zachowuje obecnie domyślnie kopię +poprzedniej wersji pakietu (\code{tlmgr option autobackup 1}), zatem +aktualizacja może zostać łatwo cofnięta poprzez \code{tlmgr restore}. +W~przypadku ograniczonej ilości miejsca na dysku, opcja ta może zostać +wyłączona przez \code{tlmgr option autobackup 0}. + +Dołączono nowe programy: p\TeX\ i~narzędzia do składu w~języku japońskim, +\BibTeX{}U dla obsługi Unicode w~\BibTeX-u, chktex +(\url{http://baruch.ev-en.org/proj/chktex}) -- program do sprawdzania +dokumentów \AllTeX, dvisvgm -- konwerter DVI do SVG +(\url{http://dvisvgm.sourceforge.net}) oraz binaria dla nowych platform +sprzętowych: \code{amd64-freebsd}, \code{amd64-kfreebsd}, +\code{i386-freebsd}, \code{i386-kfreebsd}, \code{x86\_64-darwin}, +\code{x86\_64-solaris}. + +W~dokumentacji zmian poprzedniego wydanie (\TL{} 2009) nie zdążono uwzględnić +usunięcia wielu programów uruchomieniowych dla \TeX4ht +(\url{http://tug.org/tex4ht}) oraz zastąpienia ich jednym programem +\code{mk4ht}. + +Wreszcie, z~powodu niewystarczającej ilości miejsca na płycie \TK\ \DVD, +zrezygnowano z~możliwości uruchamiania \TL{} w~trybie ,,live''. Jednocześnie +znacznie przyspieszyło to sam proces instalacji \TL{} z~płytki \DVD. + +\subsection{Wydanie 2011} + +Edycja 2011 zawierała stosunkowo niewiele zmian w porównaniu do poprzednich +wydań. + +Programy dla \MacOSX\ (\code{universal-darwin} i \code{x86\_64-darwin}) +działają od tego momentu tylko dla wersji Leopard i późniejszych. Wersje +Panther i Tiger nie będą obsługiwane. + +Dla większości platform dołączono program \code{biber}, służący do +przetwarzania danych bibliograficznych. Rozwój tego programu jest ściśle +związany z pakietem \code{biblatex}, który w zupełnie nowy sposób +obsługuje bibliografie w~La\TeX-u . + +Program MetaPost (\code{mpost}) ani nie tworzy, ani już więcej nie +wykorzystuje pliku formatu \code{.mem}. Wymagane pliki (np. \code{plain.mp}) +są po prostu wczytywane przy każdym uruchomieniu. Zmiana (choć niezauważalna +dla przeciętnego użytkownika) związana jest z nowym, innym podejściem: +MetaPost jest obecnie traktowany jako biblioteka programów. + +Zaprogramowany w Perl program \code{updmap} (uprzednio stosowany tylko w +Windows) został dostosowany do wszystkich platform. Również te zmiany +są niezauważalne dl użytkownika, choć znacznie przyspieszyły działanie +programu. + +\htmlanchor{news} +\subsection{Obecna edycja} +\label{sec:tlcurrent} + +Program \code{tlmgr} pozwala na aktualizacje z~kilku repozytoriów w~sieci. +Szczegóły zawarto w~pomocy (\code{tlmgr help}), w~części dotyczącej wielu +repozytoriów. + +Dla parametru \cs{XeTeXdashbreakstate} (\code{xetex} i~\code{xelatex}) +ustawiono domyślnie wartość~1. Pozwala to na łamanie wierszy po myślnikach +i~separatorach zakresu liczb, co było zawsze typowe dla kompilacji +programami \TeX, \LaTeX, Lua\TeX, itp. +Chcąc zachować dotychczasowe dokładne miejsca łamania, +pliki kompilowane programem \XeTeX\ wymagają zatem użycia polecenia +\cs{XeTeXdashbreakstate=0}. + +Wynikowe pliki \code{pdftex} oraz \code{dvips} mogą obecnie przekroczyć +wielkość 2GB. + +Dotychczas program \code{dvips} korzystał ze zbyt wielu różnych wersji +standardowych 35~fontów postscriptowych. Nie były one domyślnie włączane +do pliku wynikowego, bo zakładano, że urządzenia drukujące bądź programy +(np. GhostScript) mają dostęp do odpowiednich fontów. +Od tej edycji fonty ze standardowego zestawu, dostarczone w~dystrybucji \TL, +domyślnie są włączane do tworzonego przez \code{dvips} pliku. + +W zastrzeżonym trybie pracy \cs{write18} (ustawianym domyślnie) dopuszczono +uruchamianie programu \code{mpost}. + +Plik konfiguracyjny \code{texmf.cnf} znajdywany jest obecnie także +w~drzewie katalogów \filename{../texmf-local}, np. +\filename{/usr/local/texlive/texmf-local/web2c/texmf.cnf}. + +Skrypt \code{updmap} wczytuje \code{updmap.cfg} z~kolejnych drzew \TeX-owych, +zamiast jeden plik globalny. Zmiana nie powinna być zauważalna, chyba że +zmienimy ręcznie \code{updmap.cfg}. Uruchomienie \code{updmap --help} +pokaże szczegóły. + +Dodano binaria dla \pkgname{armel-linux} and \pkgname{mipsel-linux}. +Usunięto z~głównej dystrybucji binaria dla \pkgname{sparc-linux} +i~\pkgname{i386-netbsd}, ale są one nadal dostępne (wraz z~binariami dla +kilku innych platform) na stronie: +\url{http://tug.org/texlive/custom-bin.html}. + +\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{\enspace Przyszłe wersje} + +\emph{Niniejsza dystrybucja nie jest doskonała!} Planujemy kontynuować +wydawanie nowych wersji i~chcielibyśmy, żeby zawierały one jeszcze więcej +pomocnej dokumentacji, więcej programów użytkowych, lepsze programy +instalacyjne oraz 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 mnóstwo swojego wolnego czasu. Wiele jeszcze został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 pod adres: +%\begin{quote} +\email{tex-live@tug.org}. +%\url{http://tug.org/texlive} +%\end{quote} + +%Uaktualnienia, ogłoszenia i~wskazówki będą dostępne na stronie +%\url{http://tug.org/texlive.html}. + +\end{document} + |