From db0fef4fba38f67dd14b19eeaaf85f057448f41d Mon Sep 17 00:00:00 2001 From: Staszek Wawrykiewicz Date: Fri, 19 Jan 2007 18:51:54 +0000 Subject: polish tl doc git-svn-id: svn://tug.org/texlive/trunk@3596 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-doc/source/polish/texlive-pl/live.tex | 704 ++++++++++++++------- 1 file changed, 459 insertions(+), 245 deletions(-) (limited to 'Master/texmf-doc/source') diff --git a/Master/texmf-doc/source/polish/texlive-pl/live.tex b/Master/texmf-doc/source/polish/texlive-pl/live.tex index 518fd463fae..1f25d45e854 100644 --- a/Master/texmf-doc/source/polish/texlive-pl/live.tex +++ b/Master/texmf-doc/source/polish/texlive-pl/live.tex @@ -1,5 +1,5 @@ % iso8859-2 -% $Id: live.tex,v 24 2005/11/01 +% $Id: live.tex, v. 28 2007/01/19 % TeX Live documentation. % Originally written by Sebastian Rahtz and Michel Goossens, % now maintained by Karl Berry and others. @@ -35,14 +35,14 @@ \begin{document} \title{{\huge \textit{Przewodnik po \protect\TL}\\\strut} - {\LARGE \textsf\TK{} 2005} + {\LARGE \textsf\TK{} 2007} } -\author{Redakcja: Sebastian Rahtz \& Karl Berry \\[3mm] +\author{Redakcja: Karl Berry \\[3mm] \url{http://tug.org/texlive/} } -\date{Listopad 2005} +\date{Styczeń 2007} \maketitle %\thispagestyle{empty} % no need for page number @@ -107,10 +107,16 @@ podamy tu skr \begin{itemize*} \item głównym skryptem instalacyjnym dla systemów Unix i~\MacOSX{} jest -\texttt{install-tl.sh}; +\texttt{install-tl.sh}; użytkownicy Linuksa mogą wypróbować +\texttt{setuptl/tlpmgui-\var{}}, +nowy program instalacyjny o interfejsie graficznym. Bardziej szczegółowe +informacje na ten temat można znaleźć w rozdziale \ref{sec:win-install} +na str.~\pageref{sec:win-install}. \item pojedyncze pakiety instalujemy za pomocą skryptu -\texttt{install-pkg.sh}; +\texttt{install-pkg.sh}; (Po wykonaniu instalacji za pomocą \texttt{tlpmgui}, +program można użyć ponownie do dodania lub usunięcia pojedynczych pakietów +lub kolekcji.) \item programem instalacyjnym dla Windows jest \texttt{tlpmgui.exe}. Program ten może być użyty wielokrotnie do dodawania bądź usuwania pakietów, @@ -235,7 +241,7 @@ Poszczeg \texttt{00\var{typ}.TL}, znajdującego się w~głównym katalogu każdej z~płytek. Każda z~grup użytkowników systemu \TeX{} może rozpowszechniać dowolną -płytkę wedle własnych potrzeb i~uznania (\acro{TUG} dostarcza swoim +płytkę wedle własnych potrzeb i~uznania. (\acro{TUG} dostarcza swoim członkom wszystkie trzy płytki). \subsection{Główne katalogi} @@ -243,7 +249,7 @@ cz Poniżej wymieniono ważniejsze podkatalogi głównego katalogu dystrybucji \TL. Na płytce \pkgname{live} \DVD cała dystrybucja \TL{} została -umieszczona w katalogu \dirname{texlive}, nie zaś w~katalogu głównym +umieszczona w katalogu \dirname{texlive2007}, nie zaś w~katalogu głównym (poniżej traktujemy go jako katalog główny we wszystkich odniesieniach dotyczących \TL). @@ -255,11 +261,12 @@ bin & wykonywalne programy \TeX-owe, zorganizowane w~podkatalogach wed platform systemowych; \\ %MacOSX & programy pomocnicze dla użytkowników MacOSX (patrz % część~\ref{sec:mac-install} na str.~\pageref{sec:mac-install}); \\ +setuptl & programy instalacyjne dla Linuksa i~Windows; \\ source & źródła wszystkich programów, włącznie z~głównymi dystrybucjami \Webc{} \TeX-a i~\MF{}-a; są one umieszczone w~skompresowanym programem bzip2 archiwum tar; \\ -support & różne programy związane z~\TeX-em, które \emph{nie} - są domyślnie instalowane, takie jak Musix\TeX{} i~inne programy pomocnicze; +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); \\ @@ -273,9 +280,6 @@ texmf-doc & drzewo samodzielnych dokumentacji (m.in. podr niezwiązane z~konkretnymi pakietami, zorganizowane wg. języków. \\ texmf-var & drzewo dla plików generowanych automatycznie (patrz: \texttt{TEXMFSYSVAR} w~następnej części);\\ -xemtex & programy pomocnicze - dla Windows; w~systemach Unix programy te są zazwyczaj dostępne bądź łatwe - do samodzielnego skompilowania. \\ \end{tabular} \endgroup @@ -346,15 +350,16 @@ od prawej do lewej. W~trybie domy standardowym programem \TeX. Więcej szczegółów znaleźć można na \CD, w~\OnCD{texmf-dist/doc/etex/base/etex_man.pdf}. -\item [pdf\TeX] program, który wynik składu może zapisywać zarówno +\item [pdf\TeX] program, który wykorzystuje rozszerzenia programu \eTeX\ +i~wynik składu może zapisywać zarówno w~formacie Acrobat PDF, jak i~\dvi{}. Podręczniki znajdziemy w~katalogu \OnCD{texmf/doc/pdftex/manual/}, zaś przykład wykorzystania w~pliku \OnCD{texmf/doc/pdftex/manual/samplepdf/samplepdf.tex}. - %\LaTeX-owy pakiet \pkgname{hyperref} posiada opcję ,,\optname{pdftex}'', - %która uaktywnia dostęp do wszystkich cech programu. +Jest on domyślnym programem dla większości formatów (prócz plain \TeX). -\item [pdfe\TeX] łączy rozszerzenia pdf\TeX\ i~\eTeX\ i~obecnie jest -używany jako domyślny program dla większości formatów (prócz plain \TeX). +\item [Xe\TeX] umożliwia kodowanie tekstów w Unicode oraz +fontów OpenType (także tych dostępnych w~systemie), przy czym stosuje +biblioteki obce, patrz \url{http://scripts.sil.org/xetex}. \item [\OMEGA{} (Omega)] program, który pracuje wewnętrznie ze znakami kodowanymi 16-bitowo (Unicode), pozwalając pracować jednocześnie @@ -589,7 +594,9 @@ jest \Ucom{\texttt{podkre \noindent W~systemie \MacOSX katalog ten znajduje się zwykle w~ramach \dirname{/Volumes} zaś nośnik montowany jest automatycznie. +} +\def\installtlsh{ \noindent Uruchamiamy skrypt instalacyjny \filename{install-tl.sh}: \begin{alltt} > \Ucom{sh install-tl.sh} @@ -597,30 +604,33 @@ jest \Ucom{\texttt{podkre Welcome to TeX Live... \end{alltt} -Po ukazaniu się głównego menu mamy do wyboru listę opcji, wprowadzanych -poprzez naciśnięcie wybranego znaku oraz klawisza Enter (nie należy +Po komunikatach powitalnych i ukazaniu się głównego menu z +listą opcji, program oczekuje wprowadzenia polecenia +poprzez naciśnięcie wybranego znaku wyświetlonego obok opcji +oraz klawisza Enter (nie należy wpisywać znaków \verb|<>|; wielkie i~małe litery są tożsame, w~przykładach podajemy małe litery). } \runlive \startinst +\installtlsh Dla uruchamiania bezpośrednio z~płytki wybieramy najpierw opcję \Ucom{d}, następnie podopcję \Ucom{1}, która pozwoli nam określić katalog na generowane przez \TeX-a pliki (fonty, formaty, pliki konfiguracyjne do modyfikacji ustawień). Jeśli odpowiadają nam ustawienia -domyślne (\dirname{/usr/local/texlive/2005}), możemy pominąć poniższy +domyślne (\dirname{/usr/local/texlive/2007}), możemy pominąć poniższy fragment. -W~naszym przykładzie użyjemy \dirname{/opt/texlive2005}: +W~naszym przykładzie użyjemy \dirname{/opt/texlive2007}: \begin{alltt} Enter command: \Ucom{d} Current directories setup: -<1> TEXDIR: /usr/local/texlive/2005 -... +<1> TEXDIR: /usr/local/texlive/2007 +..... Enter command: \Ucom{1} -New value for TEXDIR [/usr/local/texlive/TeX]: \Ucom{/opt/texlive2005} -... +New value for TEXDIR [/usr/local/texlive/TeX]: \Ucom{/opt/texlive2007} +..... Enter command: \Ucom{r} \end{alltt} @@ -630,7 +640,7 @@ w \begin{alltt} Enter command: \Ucom{r} Preparing destination directories... -... +..... Welcome to the TeX Live system! > \end{alltt} @@ -642,7 +652,7 @@ pow możemy dopisać do pliku \filename{$HOME/.profile}: \begin{alltt} PATH=/mnt/cdrom/bin/\var{archname}:$PATH; export PATH -TEXMFSYSVAR=/opt/texlive2005/texmf-var; export TEXMFSYSVAR +TEXMFSYSVAR=/opt/texlive2007/texmf-var; export TEXMFSYSVAR \end{alltt} \noindent gdzie \emph{archname} oznacza konkretną platformę. @@ -658,7 +668,7 @@ Dla pow należy dopisać do pliku \filename{$HOME/.cshrc}: \begin{alltt} setenv PATH /mnt/cdrom/bin/\var{archname}:$PATH -setenv TEXMFSYSVAR /opt/texlive2005/texmf-var +setenv TEXMFSYSVAR /opt/texlive2007/texmf-var \end{alltt} \noindent gdzie \emph{archname} -- jak wyżej. @@ -740,7 +750,7 @@ przenoszenia wyraz pliki PDF), odpowiednio: \texttt{pdfmex} i~\texttt{pdfplatex}. Potrzebne pliki formatów zostaną wygenerowane automatycznie podczas pierwszego uruchomienia danego polecenia i~zapisane w~lokalnym katalogu. Katalog ten, -domyślnie \dirname{/usr/local/texlive/2005/texmf-var/}, a~w~naszym przykładzie +domyślnie \dirname{/usr/local/texlive/2007/texmf-var/}, a~w~naszym przykładzie \dirname{/usr/local/texlive/texmf-var/}, zawiera pliki konfiguracyjne, które mogą być modyfikowane przez użytkownika. W~konfigurowaniu pomocne jest uruchomienie skryptu \cmdname{texconfig}, opisanego @@ -757,9 +767,18 @@ g > \Ucom{sh install-tl.sh} \end{alltt} (W niektórych systemach Unix może zajść potrzeba użycia \cmdname{sh5} -lub \cmdname{bash}.) - -\noindent Skrypt ten przeszukuje listy +lub \cmdname{bash}.) + +\textbf{Uwaga:} dla systemów Linux załączono w niniejszej edycji \TL{} +alternatywny program instalacyjny \texttt{setuptl/tlpmgui\var{platforma}} +(uruchamiany w~XWindow). Posiada on podobną funkcjonalność jak skrypt +\cmdname{install-tl.sh}, ale po zainstalowaniu może być także ponownie +używany do dodawania lub usuwania pakietów bądź kolekcji oraz do podstawowych +zadań konfiguracyjnych. Program został zlokalizowany dla kilku języków. +Przydatne informacje można znaleźć w rozdziale \ref{sec:win-install} na +str.~\pageref{sec:win-install}. + +\noindent Skrypt \cmdname{install-tl.sh} przeszukuje listy zestawów i~pakietów z~\CD{} oraz próbuje odgadnąć, z~jakim systemem komputerowym ma do czynienia. @@ -810,20 +829,22 @@ instalacji, przypisane zmiennym wewn \vskip-5pt \begin{ttdescription} \item [TEXDIR] katalog bazowy, w~ramach którego zostaną zainstalowane wszystkie - pliki; domyślnie jest to \dirname{/usr/local/texlive/2005}, ale można - go zmienić np. na \dirname{/opt/texlive2005}. + pliki; domyślnie jest to \dirname{/usr/local/texlive/2007}, ale można + go zmienić np. na \dirname{/opt/texlive2007}. -W systemie \MacOSX{} dostępne programy instalacyjne -(\emph{TeXShop}, \emph{ITeXMac}, \ldots) korzystają z~domyślnej +W systemie \MacOSX{} dostępne programy integrujące oprogramowanie \TeX-owe + %(frontends ???) + %(\emph{TeXShop}, \emph{ITeXMac}, \ldots) + korzystają z~domyślnej lokalizacji \teTeX{}, czyli \dirname{/usr/local/teTeX}. Wobec czego użytkownicy Mac dla instalacji \TL{} powinni rozważyć wybór -katalogu \dirname{/usr/local/teTeX} zamiast \dirname{/usr/local/texlive/2005}. +katalogu \dirname{/usr/local/teTeX} zamiast \dirname{/usr/local/texlive/2007}. \item [TEXMFLOCAL] katalog przeznaczony na lokalne pliki makr i~fontów użytkownika, a~także indywidualne, nie związane z~dystrybucją, uzupełnienia instalacji; domyślnie jest to \dirname{/usr/local/texlive/texmf-local}. -(Katalog ten jest niezależny od opisanego wyżej katalogu bazowego, ponieważ jest -przeznaczony na lokalnie dodawane makra czy fonty.) +(Katalog ten jest niezależny od opisanego wyżej katalogu bazowego, ponieważ +jest przeznaczony na lokalnie dodawane makra czy fonty.) \item [TEXMFSYSVAR] katalog, który przechowuje pliki generowane przez system (np. formaty) @@ -890,14 +911,57 @@ ju \textruntexconfig +%------------------------------------------------ +\subsubsection{Instalacja nieinteraktywna} +\label{sec:noninteractive-install} + +Katalogi domyślne można zastąpić specyfikując odpowiednio zmienne +środowiskowe i~następnie wykonać instalację nieinteraktywną,~np.: + +\begin{alltt} +> \Ucom{TEXLIVE_INSTALL_PREFIX=/opt/texlive} +> \Ucom{export TEXLIVE_INSTALL_PREFIX} +> \Ucom{echo i | sh install-tl.sh} +\end{alltt} + +Zmienna środowiskowa \envname{TEXLIVE\_INSTALL\_PREFIX} określa inny niż +domyślny (\dirname{/usr/local/texlive}) katalog instalacyjny, pozostawiając +wszystkie inne parametry bez zmian, tak więc powyższe polecenia spowodują, że +instalacja zostanie wykonana w katalogu \dirname{/opt/texlive/2007}. + +W standardowy dla systemów Unix sposób, końcowe \Ucom{echo i} można zastąpić +dowolnym zestawem poleceń przy pomocy \texttt{here} \texttt{dokument}, +zatem dowolna sekwencja poleceń może być zawarta w~skrypcie. + +Poniżej lista wszystkich możliwych nadpisań : + +\begin{ttdescription} +\item [TEXLIVE\_INSTALL\_PREFIX] + nadpisuje \dirname{/usr/local/texlive}. +\item [TEXLIVE\_INSTALL\_TEXDIR] + nadpisuje \dirname{\$TEXLIVE_INSTALL_PREFIX}/2007. +\item [TEXLIVE\_INSTALL\_TEXMFLOCAL] + nadpisuje \dirname{\$TEXLIVE_INSTALL_PREFIX/texmf-var}. +\item [TEXLIVE\_INSTALL\_TEXMFSYSVAR] + nadpisuje \dirname{\$TEXLIVE_INSTALL_TEXDIR/texmf-var}. +\item [TEXLIVE\_INSTALL\_TEXMFHOME] + nadpisuje \dirname{\$HOME/texmf}. +\end{ttdescription} + +Zamiast powyższych zmiennych środowiskowych byłoby lepiej zastosować +\filename{configure} z~opcjami, co jest standardowym sposobem dla +stylu \acro{GNU}. Ochotnicy do wykonania takiej pracy są mile widziani! + + %------------------------------------------------ \subsection{Instalacja pojedynczych pakietów z~\protect\TL{} na twardym dysku} \TL{} można używać zarówno do aktualizacji istniejącej instalacji, jak i~do dodawania składników do instalacji wcześniejszej. Główny program instalacyjny przeznaczony jest do użycia tylko za pierwszym -razem, natomiast później należy używać znajdującego się na \CD{} (\DVD) -skryptu \texttt{install-pkg.sh}. +razem (nie dotyczy to wpomnianego wcześniej \cmdname{tlpmgui}), natomiast +później należy używać znajdującego się na \CD{} (\DVD) skryptu +\texttt{install-pkg.sh}. Uruchamia się go przez zamontowanie nośnika, przejście do katalogu punktu montowania i~wydanie polecenia: @@ -960,7 +1024,7 @@ nast \fi{} texmf/source/latex/fancyhdr/README texmf/doc/latex/fancyhdr/fancyhdr.pdf -... +..... \end{alltt} Oto inne przykłady użycia: \begin{itemize} @@ -990,20 +1054,46 @@ do~pliku \cmdname{tar}, w~katalogu \dirname{/tmp}: \fi\end{alltt} \end{itemize} -% czeka na tłumaczenie! ale mozna pominąć -%\section{Post-installation} -%\label{sec:postinstall} +% tłumaczenie: jbl (18.01.2007) +\section{Po zakończeniu instalowania} +\label{sec:postinstall} + +W każdym systemie operacyjnym, po zakończeniu głównej procedury instalacyjnej, +pozostaje wykonanie dopasowania systemu do lokalnych potrzeb i przeprowadzenie +kilku podstawowych testów. + +Innym rodzajem czynności poinstalacyjnych jest uzyskanie pakietów, fontów +lub programów, które nie zostały dostarczone z \TL{}. Podstawową zasadą jest +instalowanie takich dodatków w drzewie \envname{TEXMFLOCAL} +(jeśli instalacja została wykonana na lokalnym dysku twardym) lub drzewie +\envname{TEXMFSYSVAR} (jeśli \TeX{} jest użytkowany z płyty DVD); por. +opcja ``Installation directories'' na str.~\pageref{text:instdir}. + +Niestety, w szczegółach poszczególne procedury instalacyjne mogą się znacznie +różnić, więc nie podejmiemy tu próby ich opisania. Podamy jedynie kilka +odnośników do dokumentacji zewnętrznej: +\begin{itemize*} +\item +\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages} +\item +\url{http://www.ctan.org/installationadvice} +\item +\url{http://www.ctan.org/tex-archive/info/beginlatex/html/chapter5.html#pkginst} +\item +\url{http://www.ctan.org/tex-archive/info/Type1fonts} w szczególności są +tam szczegółowe informacje o instalowaniu fontów. +\end{itemize*} \subsection{Program texconfig} \label{sec:texconfig} Po zakończeniu instalacji i~uaktywnieniu modyfikacji zmiennej systemowej -\envname{PATH}, można użyć programu \cmdname{texconfig}, -do skonfigurowania systemu według własnych potrzeb. Program ten może -być w~każdej chwili uruchomiony do zmiany ustawień, w~trybie in\-ter\-fej\-su -pełnoekranowego lub z~linii poleceń. Program \cmdname{texconfig} powinien być -używany do wszelkich zmian, takich jak deklaracja używanych drukarek czy -przebudowywanie bazy danych o~plikach. Obydwa tryby pracy posiadają tekst pomocy, -opisujący dostępne możliwości. +\envname{PATH}, można użyć programu \cmdname{texconfig}, do skonfigurowania +systemu według własnych potrzeb. Program ten może być w~każdej chwili +uruchomiony do zmiany ustawień, w~trybie in\-ter\-fej\-su pełnoekranowego lub +z~linii poleceń. Program \cmdname{texconfig} powinien być używany do +wszelkich zmian, takich jak deklaracja używanych drukarek czy przebudowywanie +bazy danych o~plikach. Obydwa tryby pracy posiadają tekst pomocy, opisujący +dostępne możliwości. Przykłady użycia z~wiersza poleceń: @@ -1025,18 +1115,23 @@ Zlokalizujemy go uruchamiaj Plik ten zawiera sporo użytecznych komentarzy, wyjaśniających reguły ustawień domyślnych, a także podaje przykłady ustawień alternatywnych. -Od roku 2005, zgodnie ze zmianami, które zaszły w te\TeX{}~3.0, -\cmdname{texconfig} zapisuje pliki w~katalogu użytkownika -(\dirname{$HOME/.texlive2005}). Jeśli instalujemy system dla wielu +Polecenie \cmdname{texconfig} zapisuje pliki w~katalogu użytkownika, na +przykład (\dirname{$HOME/.texlive2007}). Jeśli instalujemy system dla wielu użytkowników, powinniśmy zatem uruchomić polecenie \cmdname{texconfig-sys}. Podobnie rzecz ma się ze skryptami \cmdname{updmap} oraz \cmdname{fmtutil}; -także i~one zapisują pliki w~\dirname{$HOME/.texlive2005}. Aby zmienić globalne -ustawienia, wygenerować mapy bądź formaty, należy użyć poleceń -\cmdname{updmap-sys} i~\cmdname{fmtutil-sys}. W~przypadku instalacji -dla wielu użytkowników warto wygenerować wspólne pliki formatów -(polecenie \texttt{fmtutil-sys --missing}), dzięki czemu uniknie -się generowania tychże przez każdego użytkownika, na jego własne potrzeby. +także i~one zapisują pliki w~\dirname{$HOME/.texliveRRRR}. Aby zmienić +globalne ustawienia, wygenerować mapy fontowe bądź formaty, należy użyć +poleceń \cmdname{updmap-sys} i~\cmdname{fmtutil-sys}. W~przypadku instalacji +dla wielu użytkowników warto wygenerować wspólne pliki formatów (polecenie +\texttt{fmtutil-sys --missing}), dzięki czemu uniknie się generowania tychże +przez każdego użytkownika. + +Zmienne specyfikujące katalogi modyfikowane przez powyższe polecenia +opisano w części\ref{sec:tld} na str.~\pageref{sec:tld}. +Uruchomienie polecenia \cmdname{texconfig conf} wyświetli aktualnie +używane katalogi, zaś zmiana ustawień możliwa jest poprzez modyfikację +pliku \texttt{texmf.cnf}. \subsection{Testowanie instalacji} \label{sec:test-install} @@ -1054,7 +1149,7 @@ systemu w~systemach Unix. W~\MacOSX{} i~Windows najcz TeX 3.141592 (Web2C 7.5.5) kpathsea version 3.5.3 Copyright (C) 1997-2004 D.E. Knuth. -... +..... \end{alltt} Jeśli uruchomienie zakończy się komunikatem \emph{command not found}, oznacza to, że nieprawidłowo zadeklarowano zmienną \envname{PATH}. @@ -1063,7 +1158,7 @@ oznacza to, \begin{alltt} > \Ucom{latex sample2e.tex} This is pdfeTeXk, Version 3.141592... -... +..... Output written on sample2e.dvi (3 pages, 7496 bytes). Transcript written on sample2e.log. \end{alltt} @@ -1077,7 +1172,14 @@ diagnostyka opisana w~cz \begin{alltt} > \Ucom{xdvi sample2e.dvi} \end{alltt} -Polecenie to wymaga uruchomionego środowiska graficznego X~Window. +Polecenie to wymaga uruchomionego środowiska graficznego X~Window. +Dla MS Windows analogicznym poleceniem jest \cmdname{dviout}. + %! + % You should see a new window with a nice document explaining some of the + %basics of \LaTeX{}. (Well worth reading, by the way if you're new to the + %system.) You do have to be running under X for \cmdname{xdvi} to work; if + %you're not, or your \envname{DISPLAY} environment variable is set + %incorrectly, you'll get an error \samp{Can't open display}. \item Przetwarzanie wyniku składu do \PS{} w~celu wyświetlenia lub wydruku: \begin{alltt} @@ -1217,14 +1319,11 @@ program \cmdname{tlpmgui} wykorzystuje jako ,,silnik'' program \cmdname{tlpm}. -Oprogramowanie dla Windows w~\TL{} jest oparte o~zaktualizowane -programy, zapożyczone z~projektu \XEmTeX{}, sukcesora dystrybucji -\fpTeX{} (patrz \url{http://www.metz.supelec.fr/~popineau/xemtex-1.html}). -Zawiera ponadto niektóre starsze (ale nadal działające) programy, -szczególnie przeglądarkę plików \texttt{dvi}, \textsf{Windvi}, która jest -podobna w~użyciu do znanego z~systemów Unix programu \textsf{xdvi}. -Dokumentacja \textsf{Windvi} znajduje się -w~\OnCD{texmf/doc/html/windvi/windvi.html}. +Oprogramowanie dla Windows w~\TL{} jest oparte o~zaktualizowane programy, +zapożyczone (dzięki uprzejmości Akira Kakuto) z~dystrybucji W32TEX. Zawiera +ono także niektóre starsze (ale nadal działające) programy, które napisał +Fabrice Popineau, szczególnie zaś nową przeglądarkę plików \texttt{dvi}, +\textsf{dviout}, autorstwa Toshio Oshimy. \TL{} może być instalowany w systemach Windows 98, \acro{ME}, \acro{NT}, \acro{2K} lub \acro{XP}. @@ -1238,8 +1337,8 @@ przed instalacj Po włożeniu płyty do napędu \acro{CD}, autostart powinien uruchomić program \cmdname{tlpmgui}. Jeśli to nie nastąpi, kliknij menu \guiseq{Start\arw -Uruchom} i~wybierz \verb|:\setup-win32\tplmgui.exe| (lub -\verb|:\texlive\setup-win32\tplmgui.exe| jeśli instalujesz +Uruchom} i~wybierz \verb|:\setuptl\tplmgui.exe| (lub +\verb|:\texlive\setuptl\tplmgui.exe| jeśli instalujesz z~płyty \TeX{} Collection DVD), a~następnie kliknij OK. Ukaże się okno instalatora zatytułowane \guiseq{Program instalacji @@ -1278,13 +1377,12 @@ mo kolekcje, takie jak Metapost, Omega lub dokumentacje w~różnych językach. Wybór zaznaczamy haczykiem. -\textbf{Uwaga:} - Kolekcje \guiseq{Ghostscript}, \guiseq{Perl} i~\guiseq{Wintools} są -zaznaczone domyślnie i~powinny zostać zainstalowane, ponieważ są wymagane -przez wiele programów. Można z~nich zrezygnować, gdy masz je już -zainstalowane i~wiesz, co robisz. - -Ustawiane są także zmienne środowiskowe \verb|PERL5LIB| i~\verb|GS_LIB|. +Kolekcja \guiseq{Wintools} jest zaznaczona domyślnie. Zawiera ona szereg +niewielkich, acz przydatnych programów, zwykle nieobecnych w~Windows, m.in. +konwertery grafiki \cmdname{sam2p}, \cmdname{jpeg2ps}, \cmdname{tiff2png}, +programy (de)kompresji plików (\cmdname{bzip2}, \cmdname{gzip}, +\cmdname{unzip}), a~także \cmdname{wget} wymagany przez nowe narzędzie: +\cmdname{getnonfreefonts}. W~sekcji \guiseq{Modyfikacja schematów}, po przyciśnięciu przycisku \guiseq{Wybierz} przy \guiseq{Kolekcjach języków}, otwiera się okno, w~którym @@ -1292,10 +1390,20 @@ mo konkretnych języków. Wybór zaznaczamy haczykiem. Właściwa instalacja rozpoczyna się po naciśnięciu przycisku -\guiseq{Instaluj}. Zaczekaj cierpliwie aż do pojawienia się komunikatu -o~pomyślnym zakończeniu instalacji. +\guiseq{Instaluj}. -Do menu \guiseq{Start\arw Programy\arw TeXLive2005} dodawany jest skrót +\textbf{Uwaga:} \guiseq{Perl} i~\guiseq{Ghostscript} są instalowane tylko +na życzenie. Są one wymagane przez wiele programów, ale można zrezygnować +z~ich instalacji, gdy są już zainstalowane i~wiesz, co robisz. +Ustawiane są także zmienne środowiskowe \verb|PERL5LIB| i~\verb|GS_LIB|, +a~także do \verb|PATH| dodawana jest ścieżka do programów Ghostscipta. +W~każdym razie \guiseq{Perl} i~\guiseq{Ghostscript} powinny być +obecne w~systemie. + +Ponieważ \TL{} wymaga pewnych czynności konfiguracyjnych, zaczekaj cierpliwie +aż do pojawienia się komunikatu o~pomyślnym zakończeniu instalacji. + +Do menu \guiseq{Start\arw Programy\arw TeXLive2007} dodawany jest skrót do \cmdname{tlpmgui}. Jeśli to będzie konieczne (Win9x/WinME), będziesz poproszony o~ponowne @@ -1338,7 +1446,7 @@ Wszystkie takie programy dla Windows dosy ale ponieważ jest ich spory wybór, postanowiliśmy te najbardziej godne polecenia umieścić w~dystrybucji \TL: \begin{itemize*} -\item \cmdname{Ghostscript} 7.07; +\item \cmdname{Ghostscript} 8.54; \item minimalną dystrybucję \cmdname{Perl} 5.8, wystarczającą do uruchomienia wszystkich, zawartych na \TL{} skryptów perlowych; %\item \cmdname{ImageMagick} 5.5.6 @@ -1349,12 +1457,9 @@ polecenia umie \texttt{gzip}, \texttt{jpeg2ps} i~\texttt{tiff2png}) \end{itemize*} -Powyżej wymienione programy zapożyczono z~dystrybucji \XEmTeX{}, -sukcesora fp\TeX. - -Programy \cmdname{Perl} i~\cmdname{Ghostscript} są instalowane domyślnie, +Programy \cmdname{Perl} i~\cmdname{Ghostscript} są instalowane na życzenie, ponieważ są wymagane do uruchamiania wielu ważnych narzędzi. -Istnieje jednakże możliwość rezygnacji z~instalowania obu tyvh programów, jeśli +Nie ma jednak potrzeby instalowania obu tych programów, jeśli mamy je już dostępne w~systemie. Poniżej zamieszczono listę miejsc, skąd można pobrać programy pomocnicze: @@ -1381,12 +1486,13 @@ Poni \item TeXnicCenter -- kolejny, dosyć bogaty edytor (\url{http://www.toolscenter.org/products/texniccenter/}) \item \cmdname{Vim} -- rozbudowany i~bardzo silny edytor, wywodzący się - z~klasycznego dla systemów Unix \cmdname{vi}, dostępny na \TL{} - w~katalogu \dirname{support/vim} (\url{http://www.vim.org}) + z~klasycznego dla systemów Unix \cmdname{vi} + %, dostępny na \TL{} w~katalogu \dirname{support/vim} + (\url{http://www.vim.org}) \item \cmdname{LEd} -- polski edytor dostępny z \url{http://www.ctan.org/support/LEd} - \item \cmdname{SciTE} -- edytor dostępny w~sieci pod adresem: - \url{http://www.scintilla.org/SciTE.html} + \item \cmdname{SciTE} -- edytor dostępny + z \url{http://www.scintilla.org/SciTE.html} \end{itemize*} \end{description} @@ -1404,7 +1510,7 @@ na \url{http://www.cs.wisc.edu/~ghost/gsview/}, a~tak Po zainstalowaniu \TL{} można użyć \texttt{tlpmgui} razem z~\TL{} CD (lub \TeX{} Collection DVD) do zmian i~administracji Twoją instalacją. Skrót do \texttt{tlpmgui} dostępny jest w~menu \guiseq{Start\arw Programy\arw -TeXLive2005}. Okno programu zawiera tym razem następujące zakładki: +TeXLive2007}. Okno programu zawiera tym razem następujące zakładki: \guiseq{Dodawanie pakietów}, \guiseq{Usuwanie pakietów}, \guiseq{Zarządzanie instalacją} i~\guiseq{Odinstalowanie}. @@ -1469,7 +1575,7 @@ Zak jest warte opisu i~nie wiadomo komu jest ono potrzebne\dots :-) \textbf{Uwaga:} katalogi \path|texmf-local| (zawierający prywatne fonty, makra -itp.) oraz \path|setup-win32| (zawierający \texttt{tlpmgui} i~związane z~nim +itp.) oraz \path|setuptl| (zawierający \texttt{tlpmgui} i~związane z~nim pliki) nie są usuwane podczas odinstalowania. Katalogi te należy usunąć samodzielnie. @@ -1502,7 +1608,7 @@ tlpm --help \end{verbatim} Więcej informacji i~przykładów użycia można znaleźć -w~pliku \path|tlpm.readme| (katalog \path|setup-win32|). +w~pliku \path|tlpm.readme| (katalog \path|setuptl|). \subsection{Instalacja sieciowa} Biblioteka \KPS{} @@ -1529,22 +1635,21 @@ zasoby dla stacji Windows. i~inne generowane pliki. \end{itemize} - \subsection{Różnice w~stosunku do standardowego \Webc{} w~systemach Win32} Programy \Webc{} działające w~systemach Win32 posiadają szczególne cechy, o~których warto wspomnieć: \begin{description} -\item[\KPS{}] -- tablice haszowe, tworzone w~\TL{} przez bibliotekę - \KPS{}, są bardzo duże. Aby skrócić czas uruchamiania dowolnego programu, - wykorzystującego \KPS{}, tablice haszowe zostają umieszczone w~pamięci - współdzielonej przez procesy. W~ten sposób zmniejszono znacznie czas - uruchamiania programów wywoływanych kolejno, jeden przez drugi - (np. \texttt{tex} wywołujący \texttt{mpost} wywołujący \texttt{tex}). - Zmianę tę ukryto przed użytkownikiem, z~wyjątkiem sytuacji, gdy - zostanie użyta opcja~\texttt{-1} dla diagnostyki działania \KPS; - można wtedy śledzić wykorzystanie pamięci współdzielonej. -\item[\cmdname{kpsecheck}] -- program ten oferuje kilka opcji + %\item[\KPS{}] -- tablice haszowe, tworzone w~\TL{} przez bibliotekę + % \KPS{}, są bardzo duże. Aby skrócić czas uruchamiania dowolnego programu, + % wykorzystującego \KPS{}, tablice haszowe zostają umieszczone w~pamięci + % współdzielonej przez procesy. W~ten sposób zmniejszono znacznie czas + % uruchamiania programów wywoływanych kolejno, jeden przez drugi + % (np. \texttt{tex} wywołujący \texttt{mpost} wywołujący \texttt{tex}). + % Zmianę tę ukryto przed użytkownikiem, z~wyjątkiem sytuacji, gdy + % zostanie użyta opcja~\texttt{-1} dla diagnostyki działania \KPS; + % można wtedy śledzić wykorzystanie pamięci współdzielonej. + \item[\cmdname{kpsecheck}] -- program ten oferuje kilka opcji uzupełniających dla programu \cmdname{kpsewhich}. Pozwala na wylistowanie wszystkich plików, które występują wielokrotnie w~dostępnych drzewach katalogów texmf. Może to być przydatne, choć @@ -1569,21 +1674,22 @@ z~biblioteki DLL programu Ghostscript i~znale systemowych, niż na podstawie zmodyfikowanej przez użytkownika zmiennej \envname{PATH} (ponadto zmienne środowiskowe, szczególnie w~starszych wersjach systemu Windows, mają dość ograniczoną pojemność). -\item[\Webc{}] -- programy dla Windows posiadają kilka dodatkowych opcji - nieobecnych w~wersjach kompilowanych dla Unix i~jedną działającą nieco - inaczej: +\item[\Webc{}] -- programy dla Windows posiadają jedną dodatkową opcję + nieobecną w~wersjach kompilowanych dla Unix: \begin{itemize} - \item \texttt{-halt-on-error} pozwala zatrzymać przetwarzanie - na pierwszym napotkanym błędzie; - \item \texttt{-job-time} ustawia czas tworzonych plików na taki sam - jak pliku przetwarzanego; - \item \texttt{-time-statistics} wyświetla statystyki dotyczące czasu - przetwarzania; warto tu wspomnieć, że systemy Win9x, nie będąc prawdziwymi - systemami wielozadaniowymi, nie mają prawidłowo działającego pomiaru - czasu dla krótkotrwałych procesów, wobec tego wyświetlane wartości są - jedynie przybliżone; w~NT/2K/XP wyniki są bardziej dokładne; w~Win32 brak - polecenia \texttt{time} znanego z~systemów Unix. - \end{itemize} + % \item \texttt{-halt-on-error} pozwala zatrzymać przetwarzanie + % na pierwszym napotkanym błędzie; + % \item \texttt{-job-time} ustawia czas tworzonych plików na taki sam + % jak pliku przetwarzanego; + % \item \texttt{-time-statistics} wyświetla statystyki dotyczące czasu + % przetwarzania; + \item \path|-proctimes| wyświetla statystyki dotyczące czasu przetwarzania; + warto tu wspomnieć, że systemy Win9x, nie będąc prawdziwymi systemami + wielozadaniowymi, nie mają prawidłowo działającego pomiaru czasu dla + krótkotrwałych procesów, wobec tego wyświetlane wartości są jedynie + przybliżone; w~NT/2K/XP wyniki są bardziej dokładne; w~Win32 brak + polecenia \texttt{time} znanego z~systemów Unix. + \end{itemize} \end{description} @@ -1592,7 +1698,7 @@ systemowych, ni \subsubsection{Dvips} Plik konfiguracyjny \verb+config.ps+ programu Dvips znajduje się -w~katalogu \path|C:\TeXlive2005\texmf-var\dvips\config\|. +w~katalogu \path|C:\TeXlive2007\texmf-var\dvips\config\|. Plik ten można otworzyć w~dowolnym edytorze (np. w~\cmdname{WinShell}) po to, aby zmienić niektóre parametry działania Dvips. Najważniejsze z~nich zgrupowano w~blokach deklaracji: @@ -1649,9 +1755,9 @@ w~katalogu \path|$VARTEXMF/web2c|, a~nast \verb+updmap+. Obie czynności wykonuje odpowiednie menu programu \guiseq{tlpmgui}. -\subsubsection{Pdftex} +\subsubsection{PdfTeX} Konfiguracja programu pdf(la)tex wymaga modyfikacji pliku\\ -\verb+...\TeXlive\texmf-var\generic\config\pdftexconfig.tex+\\ +\verb+C:\TeXlive2007\texmf-var\generic\config\pdftexconfig.tex+\\ %W pliku tym możemy deklarować dodatkowe mapy fontowe wczytywane przez %program, choć obecnie tworzone są one automatycznie %przez program \cmdname{updmap} (patrz ,,Uwaga'' zamieszczona powyżej). @@ -1670,6 +1776,12 @@ formatu letter ustawia si \bs{}pdfpageheight=11 true in \end{alltt} +\subsubsection{Xe\TeX} +Xe\TeX{} dla Windows jest kompilowany wraz z fontconfig 2.4.2. +Plikiem konfiguracyjnym fontconfig jest \verb+fonts.conf+, +zaś szczegóły jego modyfikacji znajdziemy w~samym pliku, w~katalogu +wskazanym przez polecenie \texttt{kpsewhich --var-value=FONTCONFIG\_PATH}. + \subsubsection{GSView} Począwszy od wersji zgodnej z~Ghostscript 6.50, GSView jest niestety programem \textit{shareware}, wobec tego nie mógł znaleźć się na \CD. @@ -1682,28 +1794,28 @@ W~menu \verb+Media+ mo Uwagi dotyczące drukowania zawarto poniżej, w~podrozdziale~\ref{printing}. -\subsubsection{WinDvi} -\label{sec:windvi} - Program \file{tlpmgui.exe} ustawia skojarzenie plików \verb+.dvi+ -z~uruchamianiem programu \file{Windvi}, ale nie tworzy dla tego programu -ikony na pulpicie. W~miarę potrzeby należy zatem wykonać to samodzielnie bądź -uruchamiać program z~linii poleceń lub menu edytora (po jego odpowiednim -skonfigurowaniu). - -W~menu \texttt{View} -\verb+->+\texttt{Options} można ustawić niektóre parametry pracy Windvi, -np. możliwość uruchamiania programów zewnętrznych (\texttt{Allow shell}), -automatyczne odświeżanie zmienionego pliku .dvi (\texttt{Autoscan}), -tryb pracy \MF{}-a i~rozdzielczość generowanych fontów (\texttt{MF mode} -i~\texttt{Pixels per inch}), współpracę z~Ghostscriptem (\texttt{Postscript}) -itp. Po zakończeniu pracy programu parametry zapisywane są -w~pliku \verb+$HOME/windvi.cnf+ (lub \verb+Moje dokumenty/windvi.cnf+). -Położenie tego pliku można ustalić po uruchomieniu z~wiersza poleceń: -\begin{verbatim} -c:\>kpsewhich --expand-var $HOME/windvi.cnf -\end{verbatim} -W~wypadku błędnego ustawienia parametrów pracy Windvi plik konfiguracyjny -wystarczy skasować. +% \subsubsection{WinDvi} +% \label{sec:windvi} +% Program \file{tlpmgui.exe} ustawia skojarzenie plików \verb+.dvi+ +% z~uruchamianiem programu \file{Windvi}, ale nie tworzy dla tego programu +% ikony na pulpicie. W~miarę potrzeby należy zatem wykonać to samodzielnie bądź +% uruchamiać program z~linii poleceń lub menu edytora (po jego odpowiednim +% skonfigurowaniu). +% +% W~menu \texttt{View} +% \verb+->+\texttt{Options} można ustawić niektóre parametry pracy Windvi, +% np. możliwość uruchamiania programów zewnętrznych (\texttt{Allow shell}), +% automatyczne odświeżanie zmienionego pliku .dvi (\texttt{Autoscan}), +% tryb pracy \MF{}-a i~rozdzielczość generowanych fontów (\texttt{MF mode} +% i~\texttt{Pixels per inch}), współpracę z~Ghostscriptem (\texttt{Postscript}) +% itp. Po zakończeniu pracy programu parametry zapisywane są +% w~pliku \verb+$HOME/windvi.cnf+ (lub \verb+Moje dokumenty/windvi.cnf+). +% Położenie tego pliku można ustalić po uruchomieniu z~wiersza poleceń: +% \begin{verbatim} +% c:\>kpsewhich --expand-var $HOME/windvi.cnf +% \end{verbatim} +% W~wypadku błędnego ustawienia parametrów pracy Windvi plik konfiguracyjny +% wystarczy skasować. \subsection{Testowanie} @@ -1713,11 +1825,11 @@ Tutaj om Dla szybkiej kontroli poprawności instalacji należy uruchomić edytor i~otworzyć plik \verb+sample2e.tex+ -(znajduje się on w~katalogu \path|C:\TeXLive2005\texmf\tex\latex\base\|). +(znajduje się on w~katalogu \path|C:\TeXLive2007\texmf\tex\latex\base\|). Na belce z~narzędziami wybrać z~menu \guiseq{Command\arw LaTeX} (XEmacs) lub wcisnąć ikonę uruchamiania programu \verb+latex+ (WinShell). Następnie wybrać z~menu \guiseq{Command\arw View DVI} (XEmacs), lub -wcisnąć ikonę podglądu DVI (WinShell). Pierwsze uruchomienie \verb+windvi+ +wcisnąć ikonę podglądu DVI (WinShell). Pierwsze uruchomienie \verb+dviout+ zazwyczaj automatycznie generuje wymagane fonty ekranowe. Po kilku sesjach komunikaty dotyczące generowania fontów staną się rzadsze. %Warto ponadto wypróbować uruchamianie Dvips i~GSView z~programu @@ -1728,17 +1840,15 @@ do przetwarzania, naci zakończenie jego pracy. \subsection{Drukowanie}\label{printing} -Drukowanie bezpośrednio z~programu Windvi odbywa się z~wykorzystaniem -uniwersalnego sterownika druku systemu Windows. Z~definicji powinien być -on zgodny z~większością drukarek, jednakże ma on tendencję do tworzenia -olbrzymich -plików kolejek (spool) i~niektóre (starsze) wersje Windows po prostu -tego nie akceptują. Zaletą sterownika jest jedynie możliwość obsługi + Drukowanie bezpośrednio z~programu \verb+dviout+ odbywa się z~wykorzystaniem +uniwersalnego sterownika druku systemu Windows. Z~definicji powinien być on +zgodny z~większością drukarek, jednakże ma on tendencję do tworzenia +olbrzymich plików kolejek (spool) i~niektóre (starsze) wersje Windows po +prostu tego nie akceptują. Zaletą sterownika jest jedynie możliwość obsługi grafik BMP i~WFM. Stosując metodę druku via sterownik Windows należy -prawidłowo ustawić parametry rozdzielczości (patrz -podrozdział~\ref{sec:windvi}), w~przeciwnym wypadku otrzymany wydruk może być -przeskalowany (np. drukując w~rozdzielczości 600dpi na drukarce 300dpi -otrzymamy niespodziewanie 1/4 zamierzonego rozmiaru wydruku). +prawidłowo ustawić parametry rozdzielczości, w~przeciwnym wypadku otrzymany +wydruk może być przeskalowany (np. drukując w~rozdzielczości 600dpi na +drukarce 300dpi otrzymamy niespodziewanie 1/4 zamierzonego rozmiaru wydruku). Drukowanie znacznie szybsze i~bardziej niezawodne zapewni konwersja pliku \verb+.dvi+ do \verb+.ps+ programem Dvips i~wykorzystanie GSView. Z~menu @@ -1755,7 +1865,7 @@ odpowiedniego urz Jeśli nie decydujemy się na rozbudowany (ale i~bardzo silny) edytor XEmacs, możemy samodzielnie zainstalować prosty i~łatwy w~obsłudze edytor WinShell. Znajdziemy go na płytkach w~katalogu -\dirname{support/WinShell}. Wystarczy dwukrotnie kliknąć klawiszem myszy +\dirname{support/winshell}. Wystarczy dwukrotnie kliknąć klawiszem myszy na znajdującym się tam pliku \texttt{.exe}. Program uruchamiamy z~menu Start bądź z~ikony/skrótu na pulpicie. Dostosowanie do polskiej wersji Windows wymaga, prócz określenia języka @@ -1771,7 +1881,7 @@ Aby skonfigurowa \begin{itemize}\itemsep 0pt \item W zakładce DVIWin, w~polu ,,exe-file'', powinno być już wpisane -\texttt{windvi.exe}. +\texttt{dviout.exe}. \item W zakładce Ghostview należy sprawdzić, czy prawidłowo podano ścieżkę dla gsview32.exe:\\ \hspace*{1em} \verb+C:\ghostgum\gsview\gsview32.exe+ (dla wersji 3.6 @@ -1973,10 +2083,10 @@ Gdy nazwa stosowane wymiennie, a~nawet mieszane. Nie należy się dziwić gdy często spotkamy ścieżki pisane w~konwencji Unix -(a~więc separowane znakiem \texttt{/}). \fpTeX{} jest implementacją \Webc{} -i~z~zasady musi być zgodny między różnymi platformami. Dlatego właśnie -np. wszystkie pliki konfiguracyjne stosują konwencję uniksową notacji -ścieżek. +(a~więc separowane znakiem \texttt{/}). Windows-\TL{} jest implementacją +\Webc{} i~z~zasady musi być zgodny między różnymi platformami. Dlatego +właśnie np. wszystkie pliki konfiguracyjne stosują konwencję uniksową +notacji ścieżek. \subsubsection{System plików} \label{sec:clusters} @@ -2013,7 +2123,7 @@ w~systemie. Poszczeg oddzielanych separatorem \texttt{;} (średnik). Można dopisać kolejne ścieżki wskazujące położenie programów, np. \begin{verbatim} -PATH=c:\windows;c:\windows\system;c:\TeXLive2005\bin\win32 +PATH=c:\windows;c:\windows\system;c:\TeXLive2007\bin\win32 \end{verbatim} Proszę zauważyć, że ścieżki zawierające spację wymagają ujęcia w~parę znaków \verb+"+. Poczynione zmiany będą aktywne po restarcie systemu. @@ -2029,7 +2139,7 @@ PATH=c:\windows;c:\windows\system;c:\TeXLive2005\bin\win32 naciskając lewy klawisz myszy na napisie \texttt{PATH}. Pole ,,Wartość'' (Value) pokaże listę katalogów rozdzielonych separatorem \texttt{;}. Należy tu dopisać katalog zawierający programy środowiska \TeX-owego - (np. \path|c:\TeXLive2005\bin\win32|). + (np. \path|c:\TeXLive2007\bin\win32|). Gdy brak jest zmiennej \texttt{PATH}, należy kliknąć pole ,,Zmienna'', wpisać \texttt{PATH}, przenieść kursor do pola ,,Wartość'' i~wpisać tu odpowiedni katalog. @@ -2060,12 +2170,12 @@ biblioteki (DLL). Z~kolei programy uruchomieniowe (.exe) umieszczono w~niewielkich plikach, przekazujących przez nazwę parametr wywołania (nazwę formatu). Na dysku znajdziemy zatem: \begin{alltt} -18/09/2005 14:19 3 584 latex.exe -18/09/2005 14:19 3 584 pdfetex.exe -18/09/2005 14:19 524 288 tl90pdfetex.dll +2006-11-23 07:06 2 560 latex.exe +2007-01-06 23:54 1 073 664 pdftex.dll +2006-01-28 08:05 2 560 pdftex.exe \end{alltt} Każdy z~tych \emph{identycznych} programów (\texttt{latex.exe}, -\texttt{mex.exe} itp.) korzysta ze wspólnego pliku \texttt{tl90pdfetex.dll}. +\texttt{mex.exe} itp.) korzysta ze wspólnego pliku \texttt{pdftex.dll}. Podobne rozwiązanie zastosowano dla grupy programów \texttt{mktex*.exe}, z~których każdy jest powiązany z~biblioteką \texttt{mktex.dll}. W~dystrybucji dostępny jest program \texttt{irun.exe}, który tworzy @@ -2077,9 +2187,60 @@ w~systemach Win32 odpowiedniki dowi \subsubsection{Co zrobić gdy \texttt{latex} nie może znaleźć potrzebnych plików?} -Należy użyć programu \cmdname{kpsewhich}, który jest narzędziem -do diagnostyki wszelkich problemów związanych ze znajdowaniem plików -(patrz część~\ref{sec:Debugging} na str.~\pageref{sec:Debugging}). +\begin{itemize} +\item Program \cmdname{kpsewhich} jest podstawowym narzędziem do diagnozowania +problemów. Wyprowadza on informacje diagnostyczne na wyjście stderr, przy czym +konsole (wiersze 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 (wiersza poleceń). Otóż dla celów diagnostycznych +można tymczasowo zdefiniować zmienną środowiskową (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-path $TEXMFCNF| & + \path|.;c:/TeX/texmf-var/web2c;| \\ + \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, +powinny one zostać usunięte, mają bowiem pierwszeństwo nad tymi, +które określono w 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/latex.fmt| + \end{tabular} +} + +Jeśli sprawdzenia nie wykazały odstępstw, \TeX{} i programy towarzyszące powinny +działać. Jeśli tak nie jest, należy poeksperymentować z opcją \path|-debug=n| +programu \path|kpsewhich| i zweryfikować wszystkie uzyskane wartości. Po +zidentyfikowaniu problemu warto go zgłosić. +\end{itemize} + +%Należy użyć programu \cmdname{kpsewhich}, który jest narzędziem +%do diagnostyki wszelkich problemów związanych ze znajdowaniem plików +%(patrz część~\ref{sec:Debugging} na str.~\pageref{sec:Debugging}). \subsubsection{Co zrobić gdy instalacja nadal nie działa prawidłowo?} @@ -2088,10 +2249,7 @@ Nale \item czy program \file{tex.exe} jest w~ścieżce wymienionej w~zmiennej \envname{PATH}? \item czy zmienna \envname{TEXMFCNF} jest prawidłowo ustawiona - (standardowo \path|c:/TeXLive2005/texmf-var/web2c|)? - %\item czy są jakieś błędy w pliku \verb+.log+ utworzonym przez program - % \file{TeXSetup.exe}? W~pliku \verb+.log+ należy wyszukać słowo - % ,,\verb+Error+''. + (standardowo \path|c:/TeXLive2007/texmf-var/web2c|)? \item diagnostyka błędów omówiona została w~części~\ref{sec:Debugging}. \item opis znanych problemów i~ewentualne rozwiązania oraz poprawki można znaleźć pod adresem \url{http://www.tug.org/tex-live.html}. @@ -2187,12 +2345,11 @@ Opiszemy najpierw og 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 czy istnieje dany element ś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). +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 czy istnieje dany element ś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ć @@ -2335,9 +2492,9 @@ znajdziemy za pomoc Wszystkie definicje czytane są zanim cokolwiek zostanie rozwinięte, tak więc do zmiennych odwoływać się można przed ich zdefiniowaniem. \end{itemize} -Fragment pliku konfiguracyjnego ilustrujący większość powyższych cech +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}. @@ -2617,7 +2774,7 @@ w~systemie brak gotowych wygenerowanych czcionek \samp{.pk} Computer Modern > \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 +..... 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 @@ -2654,46 +2811,46 @@ wyra /usr/local/texmf-var/fonts/map/dvips/updmap/psfonts.map \end{alltt} -Następnie przyjrzymy się bliżej plikom pomocniczym fontów Quasi Times -(zawierają one m.in. poprawne polskie znaki diakrytyczne). +Następnie przyjrzymy się bliżej plikom pomocniczym fontów Times z~kolekcji +URW. W~standardzie nazewnictwa fontów posiadają 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.qtm} -/usr/local/texmf-dist/dvips/qfonts/config.qtm +> \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 +qtm.map + p +utm.map \end{alltt} -wskazujący na plik \file{qtm.map}, który chcemy zlokalizować w~następnej +wskazujący na plik \file{utm.map}, który chcemy zlokalizować w~następnej kolejności: \begin{alltt} -> \Ucom{kpsewhich --format=map qtm.map} -/usr/local/texmf-dist/fonts/map/dvips/qfonts/qtm.map +> \Ucom{kpsewhich utm.map} + /usr/local/texmf-dist/fonts/map/dvips/times/utm.map \end{alltt} Plik z~przemapowaniem definiuje nazwy czcionek PostScriptowych Type~1 -w~zestawie fontów Quasi Times, zaś jego zawartość wygląda następująco +w~zestawie fontów URW, zaś jego zawartość wygląda następująco (pokazane są tylko fragmenty wierszy): \begin{alltt} - qtmr QuasiTimes-Regular ... \Ucom{kpsewhich qtmr.pfb} -\ifSingleColumn -/usr/local/texmf-dist/fonts/type1/qfonts/qtmr.pfb -\else -/usr/local/texmf-dist/fonts/type1/ -... qfonts/qtmr.pfb +> \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. Ważne jest to zwłaszcza wówczas, gdy istnieje podejrzenie, że gdzieś +pliku. Ważne jest to zwłaszcza wówczas, gdy istnieje podejrzenie, że gdzieś zawieruszyła się zła wersja jakiegoś pliku; \cmdname{kpsewhich} pokaże tylko pierwszy napotkany plik. @@ -3022,32 +3179,48 @@ Niniejsza edycja \TL{} zosta Rahtza i~Karla Berry, przy głównym współudziale: \begin{itemize*} -\item Niemieckiej Grupy \TeX-owej (\acro{DANTE e.V.}), która udostępniła - komputer, na którym przygotowywano niniejsze wydanie; a~w~szczególności - Rainera Sch\"opfa i~Reinharda Zierke, którzy opiekowali się - tym komputerem oraz Volkera Schaa i~Klausa Hoeppnera, którzy - koordynowali produkcję płytek w~wydawnictwie Lehmanns; -\item firmy Perforce, która udostępniła bezpłatną kopię świetnego - oprogramowania do zarządzania zmianami w~przygotowywanej dystrybucji; -\item Petera Breitenlohnera i~\eTeX\ teamu; +\item angielskiej, niemieckiej, holenderskiej i polskiej grup \TeX-owych + (odpowiednio \acro{TUG}, \acro{DANTE} e.V., \acro{NTG}, i~\acro{GUST}), które + wspólnie zapewniają potrzebną infrastrukturę techniczną i~organizacyjną. + Dołącz do swojej grupy \TeX-owej!; +\item zespołu \acro{CTAN}, który dystrybuuje obrazy \TL{} i~udostępnia wspólną + infrastrukturę służącą aktualizacji pakietów, od której zależy \TL{}; +\item Petera Breitenlohnera i zespołu \eTeX-owego, którzy stworzyli stabilną + podstawę przyszłych wersji \TeX-a; \item Thomasa Essera, autora wspaniałego \teTeX-a, bez którego \TL{} z~całą pewnością by nie powstał, i~którego stała pomoc umożliwiła uczynienie z~tej dystrybucji coraz lepszego produktu; +\item Michaela Goossensa, który był współautorem pierwotnej dokumentacji; \item Eitana Gurari, autora programu \TeX4ht{} (wykorzystanego do - tworzenia niniejszej dokumentacji w~wersji \HTML), który niezmordowanie pracował - nad jego ulepszaniem i~błyskawicznie wykonywał poprawki; + tworzenia niniejszej dokumentacji w~wersji \HTML), który niezmordowanie + pracował nad jego ulepszaniem i~błyskawicznie wykonywał poprawki; \item Hansa Hagena, który dostosowywał \ConTeXt\ do potrzeb \TL; +\item \Thanh{}a, Martina Schr\"odera i~pdf\TeX\ teamu za ciągłe ulepszanie + możliwości \TeX-a; +\item Taco Hoekwatera, za wznowienie rozwoju nad MetaPost i~samego \TeX-a; \item Pawła Jackowskiego, który wykonał instalator dla Windows \cmdname{tlpm} i~Tomka Łuczaka, twórcy \cmdname{tlpmgui}; -\item \Thanh{}a, Martina Schr\"odera i~pdf\TeX\ teamu; +\item Akira Kakuto, za zaktualizowanie binarów dla Windows, które są częścią + jego dystrybucji \acro{W32TEX} + (\url{http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/}); +\item Jonathana Kew i jego pracodawcy \acro{SIL}, za poważną nową ścieżkę + rozwojową, którą jest Xe\TeX{} oraz za wysiłek włożony w~zintegrowanie + programu z~\TL; +\item Reinharda Kotuchy za pomoc w~olbrzymim wysiłku aktualizowania pakietów + w~\TL, jak również za skrypt \texttt{getnonfreefonts} i~za wiele innych + prac; \item Petra Ol\shac{}\aac{}ka, który koordynował i~sprawdzał przygotowanie czeskich i~słowackich pakietów; -\item Fabrice'a Popineau, który przygotował oprogramowanie dla Windows - i~szczególnie wiele czasu poświęcił na opracowanie metod przygotowania - i~zarządzania pakietami; +\item Toshio Oshimy, za jego przeglądarkę cmdname{dviout} dla Windows; +\item Fabrice'a Popineau, który pierwszy stworzył wersje oprogramowania + dla Windows; +\item Norberta Preininga za pomoc w budowaniu infrastruktury \TL{} + i~aktualizacji pakietów, koordynowanie, wraz z~Frankiem K\"usterem, + debianowej wersji \TL{}, oraz za wiele sugestii ulepszeń; \item Staszka Wawrykiewicza, głównego testującego \TL{} w~różnych systemach, - który ponadto koordynował przygotowanie wszystkich polskich dodatków; -\item Olafa Webera, który cierpliwie pielęgnował Web2c; + 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ł oprogramowanie i~wsparcie dla \MacOSX{}; \item Grahama Williamsa, którego prace nad katalogiem pakietów bardzo @@ -3055,14 +3228,15 @@ Rahtza i~Karla Berry, przy g \end{itemize*} Binaria dla różnych platform skompilowali: -Tigran Aivazian (\pkgname{x86\_64-linux}), +Reinhard Kotucha (\pkgname{x86\_64-linux}), Manfred Lotz (\pkgname{i386-freebsd}), %Maksym Polyakov (\pkgname{sparc-solaris}), -Fabrice Popineau (\pkgname{win32}), +Akira Kakuto and Fabrice Popineau (\pkgname{win32}), Norbert Prei\-ning (\pkgname{alpha-linux}), Vladimir Volovich (\pkgname{powerpc-aix}, \pkgname{sparc-linux} i~\pkgname{sparc-solaris}), -Staszek Wawrykiewicz (\pkgname{i386-linux}), + %Staszek Wawrykiewicz + Karl Berry (\pkgname{i386-linux}), Olaf Weber (\pkgname{mips-irix}), Gerben Wierda (\pkgname{i386-darwin}, \pkgname{powerpc-darwin}). @@ -3360,9 +3534,8 @@ ale nie by \end{itemize} \subsection{Edycja 2005} -\label{sec:tlcurrent} -Aktualna edycja przyniosła, jak zwykle, mnóstwo aktualizacji pakietów +Edycja ta przyniosła, jak zwykle, mnóstwo aktualizacji pakietów i~programów. Struktura dystrybucji ustabilizowała się, niemniej jednak pojawiło się nieco zmian w~konfiguracji: @@ -3421,31 +3594,72 @@ latex --translate-file=empty.tcx twojplik.tex \end{itemize} +\subsection{Edycja 2007} +\label{sec:tlcurrent} + +Największym nowością edycji lat 2006 i~2007 jest Xe\TeX{}, +w~postaci programów \texttt{xetex} i~\texttt{xelatex}; patrz +\url{http://scripts.sil.org/xetex}. + +W istotny sposób został zaktualizowany MetaPost, planuje się 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ą obecnie zapisywane w~podkatalogach \dirname{texmf/web2c}, +choć sam ten katalog jest nadal przeszukiwany. Podkatalogi te mają nazwę +zgodną z~zastosowanym podczas generowania ,,silnikiem'', np. +\filename{tex}, \filename{pdftex} lub \filename{xetex}. Zmiana ta nie powinna +być zauważalna w~typowym użyciu. + +Program \texttt{tex} (plain) już nie analizuje pierwszego wiersza +rozpoczynającego się znakami \texttt{\%\&} aby ustalić jaki ma wczytać +format. Jest to zatem czysty, Knuthowy \TeX. \LaTeX\ i~wszystkie +pozostałe formaty nadal analizują pierwszy wiersz z~\texttt{\%\&}. + +Skrypty instalacyjne akcepują obecnie kilka zmiennych środowiska, co +umożliwia instalowanie wsadowe (nieinteraktywne) -- patrz +rozdział~\ref{sec:noninteractive-install}. + +Oczywiście, jak zwykle, w~okresie od ostatniego wydania wykonano setki innych +aktualizacji pakietów i programów. Kolejne aktualizacje można znaleźć +tradycyjnie na \acro{CTAN} (\url{http://www.ctan.org}). + +Drzewo źródłowe \TL{} jest obecnie przechowywane w~Subversion. Przeglądanie +umożliwia standardowy interfejs www, a jego adres jest opublikowany +na stronie \url{http://tug.org.pl/texlive}. +Mimo iż nie widać efektów tej zmiany w końcowej dystrybucji, mamy nadzieję, +że będzie to stabilne repozytorium oprogramowania dla rozwoju \TL{} +w~nadchodzących latach. + +Na koniec, w~maju 2006~r. Thomas Esser ogłosił, że zaprzestaje aktualizowania +dystrybucji te\TeX{} (\url{http://tug.org/tetex}). W wyniku tego znacznie +wzrosło zainteresowanie \TL-em, szczególnie wśród dystrybutorów +\acro{GNU}/Linux-a. (W \TL{} zdefiniowano w przybliżeniu równoważny, nowy +schemat instalacyjny pod nazwą \texttt{tetex}.) Mamy nadzieję, że +w~przyszłości doprowadzi to do takich ulepszeń w~otoczeniu \TeX-owym, na +których wszyscy skorzystają. + \subsection{Przyszłe wersje} -\emph{Niniejsza dystrybucja nie jest doskonała!} Planujemy wydawanie jej -raz na rok -i~chcielibyśmy żeby zawierała jeszcze więcej pomocnej dokumentacji, więcej -programów użytkowych, lepsze programy instalacyjne oraz (oczywiście) stale -ulepszany i~poprawiany katalog makr i~fontów. Zadanie to jest wykonywane -przez ciężko pracujących ochotników, poświęcających na to wiele swojego -wolnego czasu. Wiele jeszcze pozostało do zrobienia. Jeżeli możesz pomóc, -nie zastanawiaj się i~przyłącz się do nas. +\emph{Niniejsza dystrybucja nie jest doskonała!} Planujemy kontynuowanie +wydawania nowych wersji i~chcielibyśmy, żeby zawierały one jeszcze więcej +pomocnej dokumentacji, więcej programów użytkowych, lepsze programy +instalacyjne oraz (oczywiście) stale ulepszany i~poprawiany katalog makr +i~fontów. Zadanie to jest wykonywane przez ciężko pracujących ochotników, +poświęcających na to wiele swojego wolnego czasu. Wiele jeszcze pozostało do +zrobienia. Jeżeli możesz pomóc, nie zastanawiaj się i~przyłącz się do nas. Prosimy o~przesyłanie poprawek, sugestii i~uzupełnień oraz deklaracji pomocy w~opracowywaniu kolejnych edycji na adres:\hfill\null % \begin{quote} -Sebastian Rahtz\\ -{}7 Stratfield Road\\ -Oxford OX2 7BG\\ -United Kingdom\\ \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}. + +%Uaktualnienia, ogłoszenia i~wskazówki będą dostępne na stronie +%\url{http://tug.org/texlive.html}. \end{document} -- cgit v1.2.3