diff options
author | Staszek Wawrykiewicz <staw@gust.org.pl> | 2008-08-06 02:20:19 +0000 |
---|---|---|
committer | Staszek Wawrykiewicz <staw@gust.org.pl> | 2008-08-06 02:20:19 +0000 |
commit | 7a8f34d4d3de15be37ff880a8c43c8e64f2408d4 (patch) | |
tree | 93ea419797808c044d4d1d6b2796073243ea054e /Master/texmf-doc/source | |
parent | 74632c321f54b43739f014f02a84fe537e6aebf0 (diff) |
texlive-pl corrections
git-svn-id: svn://tug.org/texlive/trunk@10108 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-doc/source')
-rwxr-xr-x | Master/texmf-doc/source/texlive/texlive-pl/texlive-pl.tex | 1172 |
1 files changed, 589 insertions, 583 deletions
diff --git a/Master/texmf-doc/source/texlive/texlive-pl/texlive-pl.tex b/Master/texmf-doc/source/texlive/texlive-pl/texlive-pl.tex index 84dba6dc6c3..3f706eaed58 100755 --- a/Master/texmf-doc/source/texlive/texlive-pl/texlive-pl.tex +++ b/Master/texmf-doc/source/texlive/texlive-pl/texlive-pl.tex @@ -1,5 +1,5 @@ % iso8859-2 -% $Id: live.tex, v. 32 2008/07/29 +% $Id: live.tex, v. 33 2008/08/06 % TeX Live documentation. % Originally written by Sebastian Rahtz and Michel Goossens, % now maintained by Karl Berry and others. @@ -56,32 +56,31 @@ \subsection{\TeX\ Live i \TeX\ Collection} Niniejsza dokumentacja opisuje oprogramowanie \TL{} -- -dystrybucji \TeX-a i programów pomocniczych dla +dystrybucji \TeX-a i~programów pomocniczych dla systemów \acro{GNU}/Linux, różnych wersji Unix (w~tym \MacOSX{}) oraz Windows. -\TL{} można otrzymać ściągając go z~sieci bądź na płytce \DVD \TK{}, która -jest dostarczana przez Grupy Użytkowników Systemu \TeX{} swoim członkom. +\TL{} można ściągnąć z~sieci bądź na płytce \DVD \TK{}, którą +swoim członkom dostarczają 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 zbiorowym wysiłkiem Grup. +Zarówno \TL{}, jak i \TK{} powstały dzięki zbiorowemu wysiłkowi Grup. Tu omówimy głównie samą dystrybucję \TL. -\TL{} zawiera skompilowane programy \TeX{}, \LaTeXe{}, \mbox{\MF}, \MP, +\TL{} zawiera skompilowane programy: \TeX{}, \LaTeXe{}, \mbox{\MF}, \MP, \BibTeX{} i~wiele innych oraz bogaty zestaw pakietów makr o~wielorakim zastosowaniu, a także fonty i~dokumentacje, umożliwiające skład publikacji w~wielu językach. -Pakiety zawarte w \TL{} są regularnie aktualizowane z serwerów \acro{CTAN}: +Pakiety zawarte w~\TL{} są regularnie aktualizowane z serwerów \acro{CTAN}: \url{http://www.ctan.org}. -Lista najważniejszych zmian, jakie dokonano w~tej edycji \TL{}, -znajduje się - w~części~\ref{sec:tlcurrent}, na str.~\pageref{sec:tlcurrent}. +Lista najważniejszych zmian, które zamieszczono w~tej edycji \TL{}, +znajduje się w~części~\ref{sec:tlcurrent}, na str.~\pageref{sec:tlcurrent}. %w~części~\ref{sec:history}, na str.~\pageref{sec:history}. Nie opisujemy tu, czym jest system \TeX{}, a~jedynie kwestie instalacji i~konfiguracji oprogramowania \TL. -Początkujący użytkownicy mogą zapoznać się z~podstawowymi pojęciami +Początkujący użytkownicy mogą się zapoznać z~podstawowymi pojęciami np. w~artykule {\it Przewodnik po systemie \TeX\/}: \OnCD{texmf-doc/doc/polish/tex-virtual-academy-pl/cototex.html}. @@ -89,13 +88,13 @@ np. w~artykule {\it Przewodnik po systemie \TeX\/}: \label{sec:os_support} \TL{} zawiera oprogramowanie dla wielu platform linuksowych i uniksowych, -w~tym \MacOSX. Załączone pliki źródłowe pozwalają na zainstalowanie +w~tym \MacOSX. Załączone pliki źródłowe pozwalają też na instalację na dodatkowych platformach. -Jeśli chodzi o Windows, tylko wersje 2000 i nowsze są obsługiwane. Zaniechano -wsparcia dla Windows9x, ME oraz NT, co pozwoliło na uniknięcie specjalnej +Jeśli chodzi o Windows, to obsługiwane są wersje 2000 i nowsze. Zaniechano +wsparcia dla Windows~9x, ME oraz NT, co pozwoliło na uniknąć specjalnej (i~pracochłonnej) obsługi tych systemów w~porównaniu z~Linux/Unix. -Wprawdzie brak jest oprogramowania na wersje 64-bitowe, ale aplikacje +Chociaż brakuje oprogramowania na wersje 64-bitowe, aplikacje 32-bitowe powinny na nich działać. W części \ref{sec:tl-coll-dists} omówiono alternatywne rozwiązania @@ -104,26 +103,26 @@ dla Windows oraz \MacOSX. \subsection{Podstawy instalacji \protect\TL{}} \label{sec:basic} -\TL{} można zainstalować z \DVD{} lub internetu. Program instalacyjny +\TL{} można zainstalować z~płytki\DVD{} lub internetu. Program instalacyjny jest niewielki i pozwala pobrać z sieci wszystkie potrzebne pakiety. Jest to wygodna alternatywa, gdy potrzebujemy jedynie części oprogramowania \TL. -Posiadając płytkę \DVD{} możemy nie tylko zaistalować \TL{} na twardym dysku, -ale i~uruchomić programy bezpośrednio z~płytki (a~nawet z~obrazu +Posiadając płytkę \DVD{}, możemy nie tylko zaistalować \TL{} na twardym dysku, +ale i~uruchomić programy bezpośrednio z~niej (a~nawet z~obrazu \DVD{}, jeśli nasz system pozwala na jego zamontowanie). Szczegóły procedur instalacyjnych podane zostaną dalej w~odpowiednich rozdziałach, tu podamy jedynie skrócony przepis: \begin{itemize*} - \item program instalacyjny \filename{install-tl} posiada dwa tryby działania: -tekstowy (domyślny dla Unix/Linux) i graficzny (tzw. \GUI, domyślny dla -Windows); użyty tryb można wymusić podając parametr \code{-gui} bądź + \item program instalacyjny \filename{install-tl} może działać w~dwóch trybach: +tekstowym (domyślnym dla Unix/Linux) i~graficznym (tzw. \GUI, domyślnym dla +Windows); tryb do użycia można wymusić podając parametr \code{-gui} bądź \code{-no-gui}; \item jednym z~instalowanych programów jest \prog{tlmgr} (menedżer \TL{}), -który także może być uruchomiony w~trybie tekstowym bądź graficznym; pozwala +który również można uruchomić 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. @@ -133,13 +132,13 @@ wykonać różne czynności konfiguracyjne. \label{sec:help} Społeczność \TeX-owa jest bardzo aktywna i~pomocna, stąd też większość -poważnych zapytań nie będzie pozostawiona bez odpowiedzi. Przed zadaniem +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ę znaleźć -można na \url{http://tug.org/interest.html#vendors}.) +\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: @@ -149,11 +148,11 @@ odpowiedzi na wszelkie rodzaje pytań, od najprostszych do najbardziej zaawansowanych. Jest on załączony na \TL{} w~katalogu \OnCD{texmf-doc/doc/english/FAQ-en}, a~także dostępny w~sieci: \url{http://www.tex.ac.uk/faq}. Proponujemy -tam najpierw zajrzeć. Uruchomiono też serwis \acro{FAQ} +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., polecamy \TeX{} Catalogue. Jest to obszerne zestawienie +programu itp., to polecamy \TeX{} Catalogue. Jest to obszerne zestawienie wszelkich pakietów dotyczących \TeX-a. Patrz: %\OnCD{texmf-doc/doc/english/catalogue} lub \url{http://www.ctan.org/help/Catalogue/}. @@ -162,29 +161,29 @@ wszelkich pakietów dotyczących \TeX-a. Patrz: 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 forum pomocy to grupa +\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 mnóstwo pytań i odpowiedzi zbieranych przez wiele lat; -odpowiednio \url{http://groups.google.com/groups?group=comp.text.tex} oraz +\email{texhax@tug.org}. Warto przeszukać archiwa list dyskusyjnych, +zawierające mnóstwo pytań i odpowiedzi zbieranych przez wiele lat: +\url{http://groups.google.com/groups?group=comp.text.tex} 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, -możemy wysłać pytanie do \dirname{comp.text.tex} korzystając z~Google, +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 +Przedtem jednak \emph{należy} się zapoznać z~poradami dotyczącymi sposobu zadawania pytań, zawartymi w~\acro{FAQ}: \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}. -Polscy użytkownicy mają do dyspozycji listę dyskusyjną GUST (Grupy +Polscy użytkownicy mają do dyspozycji listę dyskusyjną GUST-u (Grupy Użytkowników Systemu \TeX); informacje o niej znajdziemy na stronie \url{http://www.gust.org.pl}. \item [wsparcie \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}. Gdy kwestia -dotyczy konkretnego programu (pakietu makr itp.) zawartego na \TL{}, -lepiej jednak skierować pytanie do osoby opiekującej się danym programem +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} @@ -192,7 +191,7 @@ lub na specjalistyczną listę dyskusyjną. 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, -a~więc zapraszamy do włączenia się, czytania wiadomości i~pomagania +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! @@ -213,10 +212,10 @@ The \TK{} \DVD{} zawiera: bezpośrednio z~płyty bądź instalacji na twardym dysku; \item [Mac\TeX] dla systemu \MacOSX; posiada on własny program instalacyjny -i dodatkowe programy dla tego systemu; strona domowa projektu: +i~dodatkowe programy dla tego systemu; strona domowa projektu: \url{http://www.tug.org/mactex/}; -\item [pro\TeX{}t] dystrybucja dla Windows, oparta na dystrybucji \MIKTEX{} +\item [pro\TeX{}t] dystrybucja dla Windows, oparta na dystrybucji \MIKTEX{}, rozszerzonej o~dodatkowe narzędzia; całkowicie niezależna od \TL; \ProTeXt\ posiada własny, łatwy w~obsłudze program instalacyjny; %i~również może być uruchamiany bezpośrednio z~płytki. @@ -240,13 +239,13 @@ 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 (poniżej traktujemy go jako katalog główny we wszystkich odniesieniach -dotyczących \TL). +do \TL). \begin{ttdescription} \item[bin] wykonywalne programy \TeX-owe, zorganizowane w~podkatalogach według platform systemowych; -\item[readme.html] krótki wstęp z użytecznymi odnośnikami; +\item[readme.html] krótki wstęp z~użytecznymi odnośnikami; \item[source] źródła wszystkich programów, włącznie z~głównymi dystrybucjami \Webc{} \TeX-a i~\MF{}-a; @@ -264,13 +263,13 @@ dotyczących \TL). fonty i~dokumentacje; patrz: \texttt{TEXMDIST} w~następnej części); \item[texmf-doc] drzewo samodzielnych dokumentacji (m.in. podręczniki itp.), - niezwiązane z~konkretnymi pakietami, zorganizowane wg. języków. + nie związane z~konkretnymi pakietami, zorganizowane wg. języków. -\item[tlpkg] skrypty, programy i inne dane potrzebne do instalacji; - katalog zawiera także ,,prywatne'' dla \TL{} kopie Perl i Ghostscript - dla Windows (nie kolidują one z posiadanymi przez użytkownika podobnymi - programami i działają tylko w ramach instalacji); poza tym dołączono - szybki i wygodny program do podglądu plików postscriptowych (a także PDF) +\item[tlpkg] skrypty, programy i~inne dane potrzebne do instalacji; + katalog zawiera także ,,prywatne'' dla \TL{} kopie systemów Perl i~Ghostscript + dla Windows (nie kolidują one z~posiadanymi przez użytkownika podobnymi + programami i~działają tylko w~ramach instalacji); poza tym dołączono + szybki i~wygodny program do podglądu plików postscriptowych (a~także PDF) -- PsView dla Windows. \end{ttdescription} @@ -281,10 +280,10 @@ 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). Dokumentacje programów (man, info) znajdują się w~katalogu \dirname{texmf/doc}, zaś dokumentacje pakietów makr, fontów i~formatów -w~katalogu \dirname{texmf-dist/doc}. Znalezienie konkretnej -dokumentacji w~dowolnym z~wymienionych katalogów ułatwi skorzystanie -z~programów \cmdname{texdoc} lub \cmdname{texdoctk}. Pomocnym może być -także plik \OnCD{doc.html}, który znajdziemy w~głównym katalogu. +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}. Pomocnym może też być +plik \OnCD{doc.html}, który znajdziemy w~głównym katalogu. Niniejsza dokumentacja w~kilku językach znajduje się w katalogu \dirname{texmf-doc}: @@ -302,35 +301,35 @@ Niniejsza dokumentacja w~kilku językach znajduje się w katalogu \subsection{Predefiniowane drzewa katalogów texmf} \label{sec:texmftrees} -W tej części wymieniono wszystkie predefiniowane zmienne specyfikujące -drzewa katalogów texmf, wykorzystywane przez -system, a~także ich przeznaczenie. Uruchomienie polecenia \texttt{texconfig -conf} pokaże wartości tych zmiennych, dzięki czemu łatwo odnaleźć, -które katalogi w~naszej instalacji są przypisane do konkretnych zmiennych. +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{texconfig conf}, zobaczymy wartości tych +zmiennych, dzięki czemu łatwo ustalimy, które katalogi w~naszej instalacji są +przypisane do konkretnych zmiennych. \begin{ttdescription} -\item [TEXMFMAIN] Drzewo katalogów zawierające podstawowe dla - dystrybucji elementy systemu, jak skrypty (np. \verb+web2c/mktexdir+), - i~inne pliki pomocnicze oraz ich dokumentacje (nie zawiera zatem +\item [TEXMFMAIN] Drzewo katalogów z~podstawowymi dla + dystrybucji elementami systemu, jak skryptami (np. \verb+web2c/mktexdir+), + i~innymi plikami pomocniczymi oraz ich dokumentację (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ć +\item [TEXMFDIST] Drzewo katalogów z~pakietami 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órego administratorzy mogą używać 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] Drzewo katalogów wykorzystywane przez narzędzia + zmiennej systemowej \verb+$HOME+ (w~Windows \verb+%USERPROFILE%+). +\item [TEXMFCONFIG] Drzewo katalogów używane 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 +\item [TEXMFSYSCONFIG] Drzewo katalogów używane przez narzędzia \verb+texconfig-sys+, \verb+updmap-sys+ oraz \verb+fmtutil-sys+ do przechowywania danych konfiguracyjnych dla całej instalacji. -\item [TEXMFVAR] Drzewo katalogów wykorzystywane przez \verb+texconfig+, - \verb+updmap+ i \verb+fmtutil+ do przechowywania wygenerowanych plików - formatów i map fontowych (domyślnie w~ramach \envname{TEXMFHOME}). +\item [TEXMFVAR] Drzewo katalogów używane 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 [TEXMFSYSVAR] Drzewo katalogów wykorzystywane przez \verb+texconfig-sys+, \verb+updmap-sys+ and \verb+fmtutil-sys+, a~także przez program \verb+tlmgr+ do przechowywania wygenerowanych plików @@ -385,49 +384,50 @@ Domyślny układ katalogów: \subsection{Rozszerzenia \protect\TeX-a} \label{sec:tex-extensions} -Standardowy \TeX{} został zamrożony, ale jest i będzie w~przyszłości dostępny -w dystrybucji. \TL{} zawiera ponadto kilka wersji rozszerzonych +Standardowy \TeX{} został zamrożony, ale jest i~będzie w~przyszłości dostępny +w~dystrybucji. \TL{} zawiera ponadto kilka wersji rozszerzonych standardowego \TeX-a: \begin{description} -\item [\eTeX] wersja \label{text:etex} programu \TeX{}, która zawiera -dodatkowo niewielki, lecz silny zestaw nowych poleceń wbudowanych -(dotyczących głównie rozwijania makr, leksemów znakowych, interpretacji -znaczników itp.) oraz rozszerzenie \TeXXeT{} dla składu -od prawej do lewej. W~trybie domyślnym \eTeX{} jest w~100\% zgodny ze -standardowym programem \TeX. Więcej szczegółów znaleźć można -w~\OnCD{texmf-dist/doc/etex/base/etex_man.pdf}. - -\item [pdf\TeX] program zbudowany na rozszerzeniu \eTeX, umożliwiający +\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, umożliwiający tworzenie plików zarówno w~formacie PDF, jak i~\dvi{}. Jest on domyślnym -programem dla większości formatów (prócz plain \TeX). Nie ma więc +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/doc/pdftex/manual/}, zaś -przykład wykorzystania w~pliku +Podręczniki znajdziemy w~katalogu \OnCD{texmf/doc/pdftex/manual/}, +przykład zaś wykorzystania -- w~pliku \OnCD{texmf/doc/pdftex/manual/samplepdf/samplepdf.tex}. -\item [Lua\TeX] jest docelowo sukcesorem pdf\TeX-a, z którym ma być -zgodny wstecz. Powinien także zastąpić Aleph (patrz niżej). Załączony +\item [Lua\TeX] jest docelowo sukcesorem pdf\TeX-a. + %z którym ma być zgodny wstecz. + Powinien także zastąpić Aleph (patrz niżej). Załączony interpreter Lua (patrz strona domowa \url{http://www.lua.org/}) -pozwala na eleganckie rozwiązanie wielu trudnych problemów \TeX-a. -Program \filename{texlua} posiada funkcjonalność samodzielnego -interpretera Lua i~w~ten sposób jest wykorzystywany w \TL{} do wielu zadań. -Patrz \url{http://www.luatex.org/} i na \DVD{} +pozwala elegancko rozwiązywać wiele 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 w~systemie), przy czym stosuje -biblioteki obce, patrz +\item [Xe\TeX] umożliwia kodowanie tekstów w~Unicode oraz korzystanie +z~fontów OpenType (także tych dostępnych w~systemie operacyjnym), +przy czym stosuje biblioteki obce, patrz \OnCD{texmf-dist/doc/xetex/XeTeX-reference.pdf} lub \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 +kodowanymi 16-bitowo (Unicode), pozwalając na jednoczesną pracę z~większością tekstów spotykanych na świecie. Wspomaga także dynamicznie ładowane tzw. ,,procesy tłumaczenia \OMEGA'' (\acro{OTP}), co pozwala -użytkownikowi definiować złożone transformacje wykonywane na dowolnych -strumieniach wejściowych. Więcej szczegółów znaleźć można na \CD: +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 też od dawna nie jest aktualizowany). @@ -469,7 +469,7 @@ postscriptowych; \item [lacheck] kontrola syntaktyki plików \LaTeX-owych; -\item [texexec, texmfstart] programy uruchomieniowe dla Con\TeX{}t; +\item [texexec, texmfstart] programy uruchamiające dla Con\TeX{}t; \item [tex4ht] konwerter \TeX{} do HTML i XML. @@ -483,10 +483,10 @@ 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, jest też jednak -możliwe zainstalowanie jedynie pojedynczego pakietu. +z~\DVD{} na twardy dysk jeden lub więcej zestawów, można też +zainstalować jedynie pojedynczy pakiet. -Zestawy pozwalają lepiej dobrać instalowane składniki, a~także określić +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 ,,basic''. Zestawy ,,latex'' i~,,pdftex'' są rekomendowane dla większości użytkowników. Pozostałe @@ -512,8 +512,8 @@ Oto dostępne zestawy i~krótki opis ich zawartości: i~instalacji fontów (zestaw do tworzenia fontów wirtualnych, manipulacji plikami .gf i~.pk, programy \texttt{mft}, \texttt{fontinst} itp.); \item[fontsrecommended] obszerna biblioteka częściej używanych fontów - w~postaci źródłowej (.mf) bądź obwiedniowych oraz pliki definicyjne - i~stylów \LaTeX-a dla tych 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[fontsextra] biblioteka różnych rzadziej używanych fontów; \item[formatsextra] pliki pomocnicze do generowania dodatkowych ,,formatów'' (tj. obszerne zestawy makr służące do wstępnego przetworzenia @@ -521,8 +521,8 @@ Oto dostępne zestawy i~krótki opis ich zawartości: \item[games] pakiety do prezentacji zapisu różnych gier (szachy, brydż itp.); \item[genericextra] obszerna biblioteka makr, trudnych do sklasyfikowania, - działających z~różnymi formatami (Plain, LaTeX itp.); -\item[htmlxml] pakiety konwersji \LaTeX{}a do XML/HTML oraz do składu + działających z~różnymi formatami (Plain, \LaTeX{} itp.); +\item[htmlxml] 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ż @@ -578,7 +578,7 @@ Oto dostępne zestawy i~krótki opis ich zawartości: %-------------------------- %%! koniec pozostawionej sekcji 27.08.2003 -Plik \texttt{tlpdb/texlive.tlpdb} (wykorzystywany podczas instalacji) +Plik \texttt{tlpdb/texlive.tlpdb} (używany podczas instalacji) zawiera spis wszystkich plików w~każdym pakiecie. \subsection{Fonty w \protect\TL} @@ -597,34 +597,34 @@ zawiera spis wszystkich plików w~każdym pakiecie. \label{sec:inst-start} Instalację \TL{} uruchamiamy skryptem \filename{install-tl} -(\filename{install-tl.bat} dla Windows) z płytki \TK{} \DVD{} -bądź dostępnym w~pakiecie instalacyjnym pobranym z sieci. +(\filename{install-tl.bat} dla Windows) z~płytki \TK{} \DVD{} +bądź dostępnym w~pobranym z~sieci pakiecie instalacyjnym. \begin{description} -\item [Instalator z sieci:] z archiwum \CTAN, z katalogu +\item [Instalator z sieci:] z~archiwum \CTAN, z~katalogu \dirname{systems/texlive/tlnet} (\url{http://mirror.ctan.org/systems/texlive/tlnet} automatycznie przekierowuje do najbliższej kopii \CTAN) należy pobrać plik -\filename{install-tl.zip} (dla Unix i Windows), lub znacznie mniejszy +\filename{install-tl.zip} (dla Unix i Windows) lub znacznie mniejszy \filename{install-unx.tar.gz} (tylko dla Unix). Po rozpakowaniu, -w katalogu \dirname{install-tl/} znajdziemy skrypty instalacyjne -\filename{install-tl} i \filename{install-tl.bat}. +w~katalogu \dirname{install-tl/} znajdziemy skrypty instalacyjne +\filename{install-tl} i~\filename{install-tl.bat}. \item [\TeX{} Collection \DVD:] po zamontowaniu płytki należy -zmienić katalog bieżący na \dirname{texlive} (w Windows program +zmienić katalog bieżący na \dirname{texlive} (w~Windows program instalacyjny powinien uruchomić się automatycznie). \DVD{} otrzymamy -w ramach członkowstwa w dowolnej Grupie Użytkowników Systemu \TeX{} -lub zamówimy (np. w Polsce \url{http://www.gust.org.pl}). +w ramach członkowstwa w~dowolnej Grupie Użytkowników Systemu \TeX{} +(kontakt w Polsce \url{http://www.gust.org.pl}). \end{description} -Dalsze kroki omówiono dokładniej w kolejnych częściach. +Dalsze kroki omówiono dokładniej w~następnych częściach. \subsubsection{Unix} \noindent Poniżej \texttt{>} oznacza prompt systemu; to, co wpisuje użytkownik, -zaznaczono \Ucom{\texttt{pogrubieniem}}. W systemach zgodnych z Unix -należy wykonać w oknie terminala: +zaznaczono \Ucom{\texttt{pogrubieniem}}. W~systemach zgodnych z~Unix +należy wykonać w~oknie terminala: \begin{alltt} > \Ucom{cd /path/to/installer} > \Ucom{perl install-tl} @@ -633,22 +633,22 @@ należy wykonać w oknie terminala: \Ucom{./install-tl}; w dalszej części nie będziemy powtarzać wszelkich możliwych kombinacji). -Dla uruchomienia w~trybie graficzny (\GUI) wymagane jest posiadania -w~systemie modułu \dirname{Perl/TK}: +Do uruchomienia w~trybie graficznym (\GUI) wymagany jest w~systemie moduł +\dirname{Perl/TK}: \begin{alltt} > \Ucom{perl install-tl -gui} \end{alltt} -Kompletny wykaz dostępnych opcji otrzymamy uruchamiając: +Kompletny wykaz dostępnych opcji otrzymamy, uruchamiając: \begin{alltt} > \Ucom{perl install-tl -help} \end{alltt} \textbf{Uwaga dotycząca uprawnień w UNIX:} aktualna podczas instalacji wartość \code{umask} będzie respektowana przez program instalacyjny. -Jeśli więc chcemy, aby instalacja była dostępna dla innych, musimy +Jeśli więc chcemy, aby instalacja była dostępna dla innych, to musimy ustawić wartość np. \code{umask 002}. Więcej informacji na temat -\code{umask} znajdziemy w podręczniku systemowym. +\code{umask} znajdziemy w~podręcznikach systemu operacyjnego. \begin{figure}[tb] \begin{boxedverbatim} @@ -698,7 +698,7 @@ Other actions: Enter command: \end{boxedverbatim} -\caption{Główny ekran instalatora w trybie tekstowym (\GNU/Linux)}\label{fig:text-main} +\caption{Główny ekran instalatora w~trybie tekstowym (\GNU/Linux)}\label{fig:text-main} \end{figure} \begin{figure}[tb] @@ -708,23 +708,23 @@ Enter command: \subsubsection{Mac\,OS\,X} -Jak wspomniano w części \ref{sec:tl-coll-dists}, dla \MacOSX +Jak wspomniano w części \ref{sec:tl-coll-dists}, dla \MacOSX{} przygotowano odrębną dystrybucję Mac\TeX\ (\url{http://tug.org/mactex}). -Dla Mac\TeX\ należy użyć dedykowanego mu programu instalacyjnego, ponieważ -dokonuje on specyficznych ustawień systemu, w szczególności pozwala +W~wypadku Mac\TeX\ należy użyć dedykowanego mu programu instalacyjnego, gdyż +zmienia on w~specyficzny sposób ustawienia systemu, w~szczególności pozwala na łatwe przełączanie pomiędzy różnymi dystrybucjami \TeX-a dla \MacOSX: Mac\TeX, gw\TeX, Fink, MacPorts,\ldots Mac\TeX\ jest oparty na \TL{} i główne drzewa katalogów są dokładnie te -same, jedynie dodawane są katalogi zawierające specyficzne dla systemu -\MacOSX\ dokumentacje i aplikacje. +same, jedynie dodawane są 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ę +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 +Można to uczynić także z~linii poleceń -- gdy katalog zawierający ten plik jest bieżącym, wystarczy uruchomić: \begin{alltt} > \Ucom{install-tl} @@ -736,7 +736,7 @@ W linii poleceń można też podać ścieżkę do programu, np.: \end{alltt} dla \TK\ \DVD, zakładając, że \dirname{D:} jest napędem \DVD. -Instalacja w trybie tekstowym wymaga podania: +Instalacja w~trybie tekstowym wymaga podania: \begin{alltt} > \Ucom{install-tl -no-gui} \end{alltt} @@ -749,24 +749,24 @@ Wszystkie dostępne opcje wyświetlimy uruchamiając: \subsubsection{Instalator w trybie tekstowym} Rysunek \ref{fig:text-main} przedstawia główny ekran programu -\filename{install-tl} w trybie tekstowym w~systemie Unix. +\filename{install-tl} w~trybie tekstowym w~systemie Unix. W tym trybie nie używamy ani klawiszy kursora, ani myszy, -tylko wyłącznie klawiszy cyfr i liter (uwaga: duże i małe litery są +tylko wyłącznie klawiszy cyfr i~liter (uwaga: duże i małe litery są rozróżniane!). Wybraną opcję zatwierdzamy klawiszem Enter. -Instalator w trybie tekstowym jest dlatego tak prosty, by działał na +Instalator w~trybie tekstowym jest dlatego tak prosty, by działał na możliwie wielu platformach, nawet wyposażonych w~ubogie biblioteki Perla -(dla Windows załączono taki podzbiór dystrybucji Perla). +(dla Windows załączono taki właśnie podzbiór dystrybucji Perla). \subsubsection{Instalator w trybie graficznym} -Rysunek \ref{fig:gui-main} pokazuje instalator w trybie graficznym +Rysunek \ref{fig:gui-main} pokazuje instalator w~trybie graficznym (zrzut ekranu w systemie Windows). \subsection{Podczas instalacji} \label{sec:runinstall} -Program instalacyjny z założenia jest na tyle prosty, aby szczegółowe -wyjaśnienia były zbędne. Podamy jednak kilka uwag dotyczących różnych opcji +Program instalacyjny jest z~założenia na tyle prosty, że szczegółowe +wyjaśnienia są zbędne. Podamy jednak kilka uwag dotyczących różnych opcji i~dostępnych podmenu. \subsubsection{Menu: binary systems (tylko Unix)} @@ -796,11 +796,11 @@ Available sets of binaries: (Dostępne zestawy programów dla:) \caption{Wybór platformy (systemu operacyjnego)}\label{fig:bin-text} \end{figure} -Rysunek \ref{fig:bin-text} pokazuje (w trybie tekstowym) wybór platformy +Rysunek \ref{fig:bin-text} pokazuje (w~trybie tekstowym) wybór platformy (systemu operacyjnego). -Domyśnie tylko programy dla bieżącej platformy są instalowane, +Domyślnie instalowane są tylko programy dla bieżącej platformy, ale menu to pozwala wybrać także zestaw dla innych platform. Może być to -przydatne do instalacji na serwerze i współdzielenia zasobów w sieci +przydatne do instalacji na serwerze i~współdzielenia zasobów w~sieci dla różnych systemów operacyjnych bądź dla instalacji %\textit{dual-boot} dla kilku systemów na tej samej maszynie. @@ -828,12 +828,12 @@ Select a scheme: (Wybór schematu do instalacji:) \end{figure} Rysunek \ref{fig:scheme-text} pokazuje menu ,,Wybór schematów''. Schematy to -obszerne zestawy pakietów przeznaczone do wstępnego wyboru instalowanych -komponentów. Mamy tu schematy dla podstawowej (\optname{basic}), -typowej (\optname{medium}) i~pełnej instalacji (\optname{full}; jest ona +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 i~GUTenberg przygotowały schematy dla swoich -członków), lub zastosowaniach (np.~XML lub Omega). +członków) lub zastosowaniach (np.~XML lub Omega). \begin{figure}[tbh] \tlpng{stdcoll}{.7\linewidth} @@ -841,13 +841,12 @@ członków), lub zastosowaniach (np.~XML lub Omega). \end{figure} Wstępnie wybrane schematy można modyfikować. W skład ,schematów'' wchodzą -tzw. ,,kolekcje'', które można wybrać w~kolejnych menu -,,Kolekcje standardowe'' i~,,Kolekcje językowe'' -(rysunek \ref{fig:collections-gui}). -Kolekcje stanowią niższy poziom i składają się z ,,pakietów''. Dopiero -pakiety zawierają właściwe pliki makr, fontów itp. Jeśli chcemy dodać -lub usunąć pakiet, po instalacji właściwej użyjemy programu \prog{tlmgr} -(patrz \ref{sec:tlmgr}). +tzw. ,,kolekcje'', które można wybrać w~kolejnych menu o~nazwach: ,,Kolekcje +standardowe'' i~,,Kolekcje językowe'' (rysunek \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 zainstalowaniu właściwej użyjemy +programu \prog{tlmgr} (patrz część~\ref{sec:tlmgr}). \subsubsection{Katalogi} \label{sec:directories} @@ -857,26 +856,27 @@ str.~\pageref{sec:texmftrees}. Położenie domyślne całej instalacji (\dirname{TEXDIR}) różni się w~Windows (|%PROGRAMFILES%\texlive\2008|) i~w~Unix (\dirname{/usr/local/texlive/2008}). -Głównym powodem dla którego zmieniamy domyślne położenie \dirname{TEXDIR} -może być brak uprawnień. Nie musimy być administratorem systemu do -zainstalowania \TL, ale musimy posiadać uprawnienia do zapisu w docelowym -katalogu. Logicznym altenatywą może być wtedy instalacja w~katalogu domowym, -szczególnie wtedy, gdy będziemy jedynym użytkownikiem. Stosujemy tu zapis -,,|~|'' do zaznaczenia takiego wyboru, np. `|~/texlive/2008|'. Zalecamy -stosowanie katalogu z rokiem wydania, co pozwoli na instalację obok siebie -różnych wydań \TL{}. +Głównym powodem, dla którego zmieniamy domyślne położenie \dirname{TEXDIR}, +może być brak uprawnień. Aby zainstalować \TL{}, nie musimy być +administratorem systemu, musimy jednak posiadać uprawnienia do zapisu +w~docelowym katalogu. Logiczną alternatywą może być wtedy instalacja +w~katalogu domowym, szczególnie wtedy, gdy będziemy jedynym użytkownikiem. +Stosujemy tu zapis ,,|~|'' do zaznaczenia takiego wyboru, np. +`|~/texlive/2008|'. Zalecamy stosowanie katalogu z rokiem wydania, co pozwoli +na 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 położenie -\dirname{TEXMFLOCAL}, \dirname{TEXMFSYSVAR} i \dirname{TEXMFSYSCONFIG}. +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 +\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 +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. @@ -897,8 +897,8 @@ podczas każdego uruchamiania programów. Znak ten rozwijany jest do zmiennej \caption{Menu: Options (Opcje) w Unix}\label{fig:options-text} \end{figure} -Rysunek \ref{fig:options-text} pokazuje menu (w trybie tekstowym) -z dodatkowymi opcjami. Warto tu wspomnieć o trzech z nich: +Rysunek \ref{fig:options-text} pokazuje menu (w~trybie tekstowym) +z~dodatkowymi opcjami. Warto tu wspomnieć o~trzech z nich: \begin{description} \item[use letter size instead of A4 by default] (użyj domyślnego formatu @@ -907,30 +907,32 @@ dla wielu programów. Oczywiście format papieru można specyfikować potem dla każdego dokumentu. \item[create all format files] (generuj wszystkie pliki formatów): -wprawdzie zbędne formaty zajmują miejsce na dysku, zalecane jest -pozostawienie tej opcji włączonej; gdy tego nie zrobimy, formaty będą -generowane automatycznie w~razie potrzeby w prywatnych katalogach -\dirname{TEXMFVAR} użytkowników, ale nie będą odświeżane, gdy w instalacji -zaktualizowane zostaną np. programy bądź wzorce przenoszenia; w skutek tego -formaty mogą być niezgodne. - -\item[create symlinks in standard directories] (utwórz dowiązania w -standardowych katalogach, tylko Unix): opcja ta pozwala uniknąć ustawiania -zmiennych środowiska po instalacji (\envname{PATH}, \envname{MANPATH} i -\envname{INFOPATH}), ale użycie nie jest zalecane, bo może powodować kolizje -z już zainstalowanym w systemie środowiskiem \TeX; może być ona przydatna -jedynie wtedy, gdy w standardowych katalogach (np. \dirname{/usr/local/bin}) +chociaż zbędne formaty zajmują miejsce na dysku, to 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. programy bądź wzorce przenoszenia; wskutek tego +formaty mogą utracić zgodność ze środowiskiem, w~którym są używane. + +\item[create symlinks in standard directories] (utwórz dowiązania + w~standardowych katalogach, tylko Unix): opcja ta pozwala uniknąć ustawiania + zmiennych środowiska po instalacji (\envname{PATH}, \envname{MANPATH} + i~\envname{INFOPATH}), ale 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. \end{description} -Gdy dokonano już wszystkich potrzebnych ustawień, można rozpocząć instalację -(klawisz ,,I''). Po instalacji proszę zajrzeć do części -\ref{sec:postinstall}, bo być może jeszcze jakieś kroki będą potrzebne. +Po wszystkich potrzebnych ustawieniach można rozpocząć instalację +(klawisz ,,I''). Po instalacji zaleca się zajrzeć do części +\ref{sec:postinstall}, bo być może potrzebne okażą się jeszcze +dodatkowe kroki. \subsubsection{Uruchamianie bezpośrednio z DVD{} (tylko w trybie tekstowym)} \label{sec:fromdvd} -Należy wybrać opcję ,,|V|'', co zmieni menu na przedstawione na +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} @@ -967,21 +969,22 @@ Other actions: \label{fig:main-fromdvd} \end{figure} -Proszę zauważyć zmiany: znikły wszystkie opcje dotyczące wyboru pakietów, -sekcja dotycząca katalogów pokazuje teraz \dirname{TEXDIRW} -- katalog z -prawami do zapisu. Pozwoli to na uruchamianie wszystkich programów +Zwróćmy uwagę na następujące zmiany: zniknęły wszystkie opcje dotyczące wyboru +pakietów, sekcja dotycząca katalogów pokazuje teraz \dirname{TEXDIRW} -- +katalog z~prawami 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}. -Z powodu pilniejszych prac i braku czasu opcja ta nie znalazła się -niestety w instalatorze \GUI, ale jest dostępna dla wszystkich systemów. -Użytkownicy Windows powinni zatem uruchomić program z linii poleceń, -jak opisano to w~części~\ref{sec:cmdline}. + %Z powodu pilniejszych prac i braku czasu + Instalator \GUI nie posiada opcji ,,V'', dlatego + %ale jest dostępna dla wszystkich systemów. + użytkownicy Windows mogą uruchomić program jedynie +z~linii poleceń, jak opisano to w~części~\ref{sec:cmdline}. -W rozdziale \ref{sec:portable-unix} opisano jeszcze inny, przenośny sposób +W~rozdziale \ref{sec:portable-unix} opisano jeszcze inny, przenośny sposób uruchamiania \TL, który nie wymaga zmian w~konfiguracji systemu (a~nawet nie pozwala na nie). @@ -997,23 +1000,23 @@ aby wyświetlić wszystkie dostępne parametry. Najbardziej interesujące to: \begin{ttdescription} -\item[-gui] użyj programu w wersji graficznej (\GUI), jeśli to możliwe; +\item[-gui] użyj programu w~wersji graficznej (\GUI), jeśli to możliwe; wymagane jest posiadanie modułu Perl/Tk (\url{http://tug.org/texlive/distro.html#perltk}); gdy jest on niedostępny, program instalacyjny uruchomiony zostanie w trybie tekstowym; -\item[-no-gui] wymusza tryb tekstowy, np. w Windows potrzebny jest on +\item[-no-gui] wymusza tryb tekstowy, np. w~Windows potrzebny jest on dla przygotowania do uruchamiania bezpośrednio z~\DVD; \item[-lang {\sl LL}] pozwala wybrać język komunikatów, \textsl{LL} oznacza tu dwuliterowy kod języka; aktualnie dostępne są: angielski (\texttt{en}, domyślny), niemiecki (\texttt{de}), francuski (\texttt{fr}), holenderski (\texttt{nl}), polski (\texttt{pl}), - słoweński (\texttt{sl}) i wietnamski (\texttt{vi}); program samoczynnie + słoweński (\texttt{sl}) i~wietnamski (\texttt{vi}); program samoczynnie włącza język, ale jeśli jest to niemożliwe, komunikaty i menu będą wyświetlane w języku angielskim; \item[-profile {\sl profile}] program instalacyjny zapisuje plik - \filename{texlive.profile} w katalogu \dirname{2008/tlpkg}, co pozwala - wykorzystać go dla powielenia wszystkich wyborów i ustawień w kolejnych + \filename{texlive.profile} w~katalogu \dirname{2008/tlpkg}, co pozwala + wykorzystać go dla powielenia wszystkich wyborów i~ustawień w~kolejnych instalacjach; %%! zbędny przykład, patrz wer. oryg. (SW) \item [-location {\sl url/path}] pozwala określić inne niż domyślne źródło @@ -1023,14 +1026,14 @@ aby wyświetlić wszystkie dostępne parametry. \subsubsection{Parametr \optname{location}} \label{sec:location} -Wartością przypisaną \optname{location} może być adres w sieci +Parametrowi \optname{location} można przypisać adres w sieci (rozpoczynający się od \texttt{ftp:}, \texttt{http:} lub \texttt{file:/}), -lub pełna ścieżka. Jeśli podany argument wskazuje na lokalny dysk -(ścieżka bądź adres \texttt{file:/}), automatycznie zostanie dostosowany +lub pełną ścieżkę. Jeśli podany argument wskazuje na lokalny dysk +(ścieżka bądź adres \texttt{file:/}), to automatycznie zostanie dostosowany typ instalacji (ze skompresowanych plików bądź nie): gdy dostępny będzie katalog \dirname{archive}, zawierający pliki \filename{.tar.lzma}, wybrana -zostanie instalacja z tych plików, nawet jeśli dostępne będą równolegle -katalogi z plikami nieskompresowanymi. +zostanie instalacja z~tychże plików, nawet jeśli dostępne będą równolegle +katalogi z~plikami nieskompresowanymi. %%! póki co, brak czasu na takie szczegóły (SW) %%! When giving an \texttt{http:} or \texttt{ftp:} location, trailing @@ -1048,26 +1051,27 @@ katalogi z plikami nieskompresowanymi. \subsection{Czynności poinstalacyjne} \label{sec:postinstall} -Część ta nie dotyczy Windows, dla których program instalacyjny przeprowadza -całą konfigurację, włącznie z menu systemowym i ikonami na pulpicie. -Dla użytkowników innych systemów mogą być przydatne poniższe uwagi. +Część ta nie dotyczy systemu Windows, dla którego program instalacyjny +przeprowadza całą konfigurację, włącznie z~menu systemowym i~ikonami na +pulpicie. Poniższe uwagi mogą być przydatne dla użytkowników innych systemów. \subsubsection{Gdy zastosujemy dowiązania symboliczne} -Użycie opisanej w części~\ref{sec:options} opcji tworzenia dowiązań -symbolicznych w standardowych katalogach nie wymaga zmian w zmiennych +Użycie opisanej w~części~\ref{sec:options} opcji tworzenia dowiązań +symbolicznych w~standardowych katalogach nie wymaga zmian w zmiennych środowiska systemowego. \subsubsection{Zmienne środowiska dla Unix} \label{sec:env} -Po instalacji wymagane jest dodanie ścieżki do programów \TL{} do zmiennej -\envname{PATH}. Każda dostępna platforma ma własny podkatalog w ramach -\dirname{TEXDIR/bin}. Listę platform i odpowiadających im katalogów +Po instalacji trzeba do zmiennej \envname{PATH} dodać ścieżkę do +programów \TL. 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}. -Aby wykorzystać systemowe przeglądarki dokumentacji \prog{man} i \prog{info}, -należy również dodać odpowiednie katalogi do ich ścieżek przeszukiwania. +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. Dla powłoki zgodnej z~Bourne shell (\cmdname{sh}, \cmdname{bash}, \cmdname{ksh}) możemy dopisać do pliku \filename{$HOME/.profile}: @@ -1078,7 +1082,7 @@ MANPATH=/usr/local/texlive/2008/texmf/doc/man:$MANPATH; export MANPATH INFOPATH=/usr/local/texlive/2008/texmf/doc/info:$INFOPATH; export INFOPATH \end{sverbatim} -Dla csh lub tcsh należy zmodyfikować plik \filename{$HOME/.cshrc}, np: +W~wypadku csh lub tcsh należy zmodyfikować plik \filename{$HOME/.cshrc}, np: \begin{sverbatim} setenv PATH /usr/local/texlive/2008/bin/i386-linux:$PATH @@ -1110,21 +1114,21 @@ setenv INFOPATH /usr/local/texlive/2008/texmf/doc/info:$INFOPATH %%! And 2)~check for a file \filename{/etc/environment} which may define the %%! search path and other default environment variables. -\subsubsection{Gdy uruchamiamy z DVD} +\subsubsection{Gdy uruchamiamy programy z~DVD} -Programy \TL{} korzystają z pliku \filename{texmf.cnf} do znalezienia -potrzebnych danych w różnych drzewach katalogów. Plik \filename{texmf.cnf} -znajdywany jest w całej serii położeń względem położenia samych programów, -ale zasada ta nie działa, gdy uruchamiamy programy bezpośrednio z~\DVD. -Wynika to z faktu, że niektóre pliki są zapisywane na twardym dysku (\DVD{} -jest medium tylko do odczytu) i tracą tym samym predefiniowane względne -położenie. Wymagane jest zatem zdefiowanie w środowisku zmiennej -\envname{TEXMFCNF}, która wskaże położenie \filename{texmf.cnf}. Nadal jest -potrzebna modyfikacja zmiennej \envname{PATH}, jak to już opisano wyżej. +Programy \TL{} wyszukują potrzebne dane w~różnych drzewach katalogów +korzystając z~pliku \filename{texmf.cnf}. Plik ten znajdowany jest w całej +serii położeń względem położenia samych programów, ale zasada ta nie działa, +gdy uruchamiamy programy bezpośrednio z~\DVD. Wynika to z faktu, że niektóre +pliki są zapisywane na twardym dysku (\DVD{} jest medium tylko do odczytu) +i~tracą tym samym predefiniowane względne położenie. Wymagane jest zatem +zdefiowanie w~środowisku zmiennej \envname{TEXMFCNF}, która wskaże położenie +\filename{texmf.cnf}. Nadal jest potrzebna modyfikacja zmiennej +\envname{PATH}, jak opisano wyżej. -Na zakończenie instalacji program powinien pokazać komunikat informujący +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 +to przeoczyli -- wartością tą jest \dirname{$TEXMFSYSVAR/web2c}, czyli dla domyślnych ustawień (\dirname{/usr/local/texlive/2008/texmf-var/web2c}) potrzebujemy deklaracji: \begin{sverbatim} @@ -1138,55 +1142,57 @@ setenv TEXMFCNF /usr/local/texlive/2008/texmf-var/web2c \subsubsection{\ConTeXt{} Mark IV} Tak zwany ,,stary'' \ConTeXt{} działa jak dotychczas. Nowy \ConTeXt{} -,,Mark~IV'' wymaga ręcznego dostrojenia, patrz: +,,Mark~IV'' wymaga ręcznego dostrojenia -- patrz: \url{http://wiki.contextgarden.net/Running_Mark_IV}. \subsubsection{Integracja lokalnych i prywatnych pakietów makr} \label{sec:local-personal-macros} -Jak już wspomniano w~części~\ref{sec:texmftrees}, \dirname{TEXMFLOCAL} +Jak już wspomniano w~części~\ref{sec:texmftrees}, katalog \dirname{TEXMFLOCAL} (domyślnie \dirname{/usr/local/texlive/texmf-local} lub \verb|C:\Program Files\texlive\texmf-local|) przeznaczony jest na lokalne (np. w~danej sieci komputerowej) fonty oraz pakiety makr. Z~kolei \dirname{TEXMFHOME} (domyślnie \dirname{$HOME/texmf} lub -\verb|%USERPROFILE%\texmf|) jest przeznaczony na prywatne makra i fonty -użytkownika. W zamierzeniu oba katalogi powinny być zachowywane przy -instalacji nowszych wersji \TL{} i~ich zawartość ma być automatycznie -,,widziana'' przez kolejne wydania. Zalecamy zatem, by nie -przedefiniowywać \dirname{TEXMFLOCAL}, co pozwoli uniknąć ręcznych -konfiguracji w~przyszłości. - -W obu drzewach katalogów pliki powinny być umieszczane w~odpowiednich +\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 +\dirname{TEXMFLOCAL} po zmianie zawartości wymaga odświeżenia bazy danych -- poleceniem \cmdname{mktexlsr} lub poprzez użycie przycisku ,,Odśwież bazy -danych'' w~graficznej wersji programu \prog{tlmgr}. +danych'' w~graficznym trybie programu \prog{tlmgr}. \subsubsection{Integracja fontów z innych źródeł} -Jest to, niestety, mocno zagmatwany temat, wymagający sporej wiedzy -użytkownika. Warto najpierw zapoznać się jakie fonty mamy dostępne bezpłatnie +Jest to, niestety, + %mocno zagmatwany temat, + bardzo skomplikowane zagadnienie, wymagające sporej wiedzy +użytkownika. Warto się najpierw zapoznać, jakie fonty mamy dostępne bezpłatnie (patrz część~~\ref{sec:tl-fonts}). -Zwrócimy tu uwagę na możliwą alternatywę w~postaci \XeTeX (patrz -częśc~\ref{sec:tex-extensions}), który pozwala użyć fontów systemowych -bez potrzeby instalowania ich dla \TeX-a. +Alternatywą jest \XeTeX{} (patrz +częśc~\ref{sec:tex-extensions}), który umożliwia użycie fontów systemowych +bez potrzeby instalowania ich dla programów \TeX-owych. \subsection{Testowanie instalacji} \label{sec:test-install} -Po zainstalowaniu \TL{} warto sprawdzić czy programy działają -prawidłowo. Opiszemy tu podstawowe procedury testujące funkcjonowanie +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), ale reguły będą podobne. +środowiska graficznego (\GUI), reguły jednak będą podobne. \begin{enumerate} -\item Sprawdzamy najpierw czy uruchamia się program \cmdname{tex}: +\item Sprawdzamy najpierw, czy uruchamia się program \cmdname{tex}: \begin{alltt} > \Ucom{tex -{}-version} @@ -1194,8 +1200,8 @@ TeX 3.1415926 (Web2C 7.5.7) kpathsea version 3.5.7 ... \end{alltt} -Jeśli uruchomienie zakończy się komunikatem \emph{command not found}, -oznacza to, że nieprawidłowo zadeklarowano zmienną \envname{PATH} +Jeśli uruchomienie kończy się komunikatem \emph{command not found}, +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: @@ -1209,8 +1215,8 @@ Transcript written on sample2e.log. Gdy program nie znajduje \filename{sample2e.tex} (bądź innych wymaganych plików), może to oznaczać, że nadal działają ustawienia zmiennych środowiska bądź pliki konfiguracyjne z~poprzedniej instalacji. -Dogłębną analizę gdzie są przeszukiwane i~znajdywane pliki umożliwia -diagnostyka opisana w~części \ref{sec:debugging} na +Szczegółową analizę, gdzie są przeszukiwane i~znajdowane pliki, +umożliwia diagnostyka opisana w~części \ref{sec:debugging} na str.~\pageref{sec:debugging}. \item Podgląd wyniku składu: @@ -1242,8 +1248,8 @@ Dla MS Windows analogicznym poleceniem jest \cmdname{dviout}. \textrm{lub:} > \Ucom{xpdf sample2e.pdf} \end{alltt} -Programy \cmdname{gv} i~\cmdname{xpdf} są dostarczane zwykle -w~ramach systemu operacyjnego, wobec tego nie zawarto ich +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 @@ -1260,7 +1266,7 @@ Program ten można też zainstalować samodzielnie w~systemach Linux \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, ale zamiast \LaTeX-a wymaga jedynie plain +\item [testfont.tex] jak wyżej, z~tym że zamiast \LaTeX-a wymaga jedynie plain \TeX{}; \item [story.tex] najbardziej kanoniczny przykład dla plain \TeX{}; na zakończenie przetwarzania uruchomionego poleceniem \samp{tex story}, @@ -1277,8 +1283,8 @@ Petera Flynna \textsl{Formatting Information}, dostępny pod adresem \section{Instalacje sieciowe} \label{sec:netinstall} -\TL{} zaprojektowano tak, aby mogło korzystać z~niego wielu -użytkowników, nawet w~różnych systemach operacyjnych w~sieci. +\TL{} zaprojektowano tak, by mogło z~niego korzystać wielu +użytkowników, nawet w~różnych systemach operacyjnych w~sieci komputerowej. 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 @@ -1289,9 +1295,9 @@ TEXMFMAIN = $SELFAUTOPARENT/texmf ... TEXMFLOCAL = $SELFAUTOPARENT/../texmf-local \end{sverbatim} -W konsekwencji oznacza to, że dla różnych systemów bądź użytkowników -wystarczy dodać do ich ścieżek przeszukiwania tylko ścieżkę do programów -\TL{}. +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. @@ -1300,8 +1306,8 @@ Użytkownicy Windows mogą mieć także inne wymagania. W~katalogu \dirname{texmf-doc/source/texlive/texlive-common/w32client} znajdziemy przykładowy skrypt \filename{install-w32client}, który pozwala dostosować istniejącą instalację \TL{} dla potrzeb sieci -(włącznie z~utworzeniem skrótów w~menu systemowym). Wystarczy uruchomić -w~tym katalogu \filename{install-w32client.bat}. +(włącznie z~utworzeniem skrótów w~menu systemowym). Wystarczy +w~tym katalogu uruchomić \filename{install-w32client.bat}. W części~\ref{sec:kpathsea} dowiemy się więcej o~konfigurowaniu \TL{} i~zasadach przeszukiwania ścieżek. @@ -1311,8 +1317,8 @@ i~zasadach przeszukiwania ścieżek. \label{sec:portable-unix} Opcja ,,uruchom z~\DVD{}'', opisana w~rozdziale~\ref{sec:fromdvd}, jest -wprzydatna, jeśli działamy na swoim własnym systemie. Gdy gościmy na cudzym -systemie, prawdopodobnie wolelibyśmy wybrać inną możliwość, bez zbędnych +wprzydatna, jeśli działamy na swoim własnym komputerze. Gdy gościmy na +cudzym, to prawdopodobnie wolelibyśmy wybrać inną możliwość, bez zbędnych skutków ubocznych. W~głównym katalogu \TL{} \DVD (w~podkatalogu \dirname{texlive} \TK{} \DVD) @@ -1321,26 +1327,26 @@ znajdziemy skrypt uniksowy \filename{tl-portable} oraz widowsowy odpowiednimi do bezpośredniego dostępu do \TL{} na \DVD. Gdy skrypt ten jest wykonywany po raz pierwszy, generowane są pewne pliki -w~podkatalogu \dirname{~/.tlportable2008}, co zabierze kilka chwil. +w~podkatalogu \dirname{~/.tlportable2008}, co trwa kilka chwil. W~kolejnych wywołaniach skrypt rozpoczyna działanie niemal natychmiast. -Reszta systemu nie jest świadoma istnienia \TL. Jeśli chcemy aby nasz edytor -mógł współpracować z~\TL, musimy uruchomić go z~drugiej, -równoległej, sesji \filename{tl-portable}. +Reszta systemu nie jest świadoma istnienia \TL. Jeśli chcemy, by nasz edytor +mógł współpracować z~\TL, to musimy uruchomić go z~innej, +równoległej sesji \filename{tl-portable}. -Można również użyć \filename{tl-portable} do wywołania \TL{} z~pendrajwa -\acro(USB). W~takim przypadku należy skopiować wszystkie pliki najwyższego +Można również użyć \filename{tl-portable} do wywołania \TL{} z~pendrive +\acro(USB). W~takim wypadku należy skopiować wszystkie pliki najwyższego poziomu oraz zawartość (co najmniej) katalogów \dirname{bin}, -\dirname{texmf}, \dirname{texmf-dist} i~\dirname{tlpkg} na pendrajw. Zajmie -to trochę czasu! Jeśli kopiujemy na pendrajw \acro{USB} sformatowany -z~systemem plików \acro{FAT}32, należy upewnić się, że dowiązania symboliczne -są zastępowane plikami (polecenie \code{cp -L}). Katalog -\dirname{texmf-local} na pendrajwie również będzie używany. +\dirname{texmf}, \dirname{texmf-dist} i~\dirname{tlpkg} na pendrive. Zajmie +to trochę czasu! Jeśli kopiujemy na pendrive \acro{USB} sformatowany +z~systemem plików \acro{FAT}32, to należy się upewnić, że dowiązania +symboliczne są zastępowane plikami (polecenie \code{cp -L}). Używany też +będzie katalog \dirname{texmf-local} na pendrive. -Następnie wywołamy \filename{tl-portable} z~katalogu głównego pendrajwa -W~tym przypadku skrypt zauważy, że pendrajw można zapisywać i~użyje go do -zapisania wygenerowanych plików. Można zapisać tę zawartość z~powrotem do -\DVD() jeśli np. jest to wygodniejsze do przekazania innym. +Następnie wywołajmy \filename{tl-portable} z~katalogu głównego pendrive'a. +W~tym wypadku skrypt zauważy, że pendrive można zapisywać i~użyje go do +zapisania wygenerowanych plików. Zawartość tę można z~powrotem zapisać na +\DVD{} (np. do przekazania innym). \section{\cmdname{tlmgr}: zarządzanie instalacją} \label{sec:tlmgr} @@ -1358,23 +1364,23 @@ kolekcji\slash schematów pokaże się dopiero po naciśnięciu klawisza konfiguracji}\label{fig:tlmgr-config} \end{figure} -Instalator instaluje program o~nazwie \prog{tlmgr} służący do dalszego +Instalator instaluje program o~nazwie \prog{tlmgr}, służący do dalszego zarządzania \TL{} po pierwotnej instalacji. Programy \prog{updmap}, -\prog{fmtutil} oraz \prog{texconfig} są nadal dostępne i będą utrzymywane -w~przeszłości, jednakże obecnie polecanym interfejsem jest \prog{tlmgr}. Jego +\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 pokazanie listy schematów, kolekcji i~pakietów; -\item instalowanie, aktualizacja, kopie zapasowe, odtwarzanie oraz usuwanie - pojedynczych pakietów (opcjonalnie~-- z~uwzględnieniem zależności pomiędzy - pakietami); +\item instalowanie, aktualizację, tworzenie kopii zapasowych, odtwarzanie + oraz usuwanie pojedynczych pakietów (opcjonalnie~-- z~uwzględnieniem + zależności pomiędzy pakietami); \item wyszczególnianie oraz dodawanie architektur (platform systemowych); -\item zmiana opcji instalacji, takich jak rozmiar papieru czy zmiana +\item zmianę opcji instalacji, takich jak rozmiar papieru czy zmiana położenia źródła instalacji (patrz część~\ref{sec:location}). \end{itemize*} -\textit{Ostrzeżenie:} \prog{tlmgr} nie był zaprojektowany ani testowany - z~instalacjami, które są wywoływane bezpośrednio z~\DVD. +\textit{Ostrzeżenie:} \prog{tlmgr} nie został zaprojektowany ani + przetestowany z~instalacjami, które są wywoływane bezpośrednio z~\DVD. \subsection{\cmdname{tlmgr} -- tryb graficzny (GUI)} \prog{tlmgr} może być uruchomiony w~trybie graficznym za pomocą polecenia @@ -1458,7 +1464,7 @@ LongDesc: Utilities for Windows, since they are not readily available there: gzip, chktex, jpeg2ps, unzip, wget, xpdf. Installed: Yes \end{fverbatim} -Aktualizacja całej instalacji do najnowszej, dostępnej wersji: +Aktualizacja całej instalacji do najnowszej dostępnej wersji: \begin{alltt} > \Ucom{tlmgr update -all} \end{alltt} @@ -1479,16 +1485,16 @@ Pełną dokumentację programu pokaże polecenie: \label{sec:windows} \TL\ ma tylko jeden program instalacyjny, działający zarówno w~Unix, -jak i~w~Windows. Stworzenie takiego programu było możliwe dopieo +jak i~w~Windows. Stworzenie takiego programu było możliwe dopiero po zaniechaniu wsparcia dla starszych wersji Windows. Obecnie -\TL\ może być instalowany tylko w~Windows 2000 i~nowszych. +\TL\ można instalować tylko w~Windows 2000 i~nowszych. \subsection{Cechy specyficzne dla Windows} \label{sec:winfeatures} W systemie Windows program instalacyjny wykonuje kilka dodatkowych czynności: \begin{description} -\item[Menu i skróty.] W menu systemowym instalowane jest podmenu ,,\TL'', +\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 @@ -1497,8 +1503,8 @@ na ikonie plików postscriptowych. \item[Automatyczne ustawienie zmiennych środowiska.] Po instalacji nie są wymagane żadne ,,ręczne'' zmiany ustawień. \item[Odinstalowanie.] Program instalacyjny rejestruje instalację -w~menu ,,Dodaj/Usuń programy'' w~Panelu sterowania; odinstalowanie zatem -odbywa się w~standardowy dla Windows sposób. +w~menu ,,Dodaj/Usuń programy'' w~Panelu sterowania; odinstalowanie +odbywa się zatem w~standardowy dla Windows sposób. \end{description} \subsection{Programy pomocnicze dla Windows} @@ -1509,23 +1515,23 @@ odbywa się w~standardowy dla Windows sposób. \end{figure} Aby instalacja była kompletna, \TL{} wymaga kilku pomocniczych -programów, które nie są dostarczane wraz z~systemem Windows. +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 takie programy dla Windows dosyć łatwo znaleźć w~sieci, -ale ponieważ jest ich spory wybór, postanowiliśmy te najbardziej istotne +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.] Oba te programy są niezbędne do -prawidłowego działania \TL, dołączyliśmy zatem \cmdname{Ghostscript} 8.62 +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; +uruchomienia wszystkich, zawartych w~\TL{} skryptów perlowych; oba programy zostały ,,ukryte'', to znaczy tylko programy \TL, które -z~nich korzystają, ,,wiedzą'' gdzie je znaleźć; tym samym nie powinny one +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 @@ -1533,10 +1539,10 @@ i~Ghostscript; %(\texttt{bzip2}, %% NIE MA!! (SW) (\texttt{gzip}, \texttt{unzip}, \texttt{jpeg2ps} i~\texttt{tiff2png}) a~także kilka narzędzi z~zestawu \cmdname{xpdf}, uruchamianych z~linii - poleceń (sam \cmdname{xpdf} nie jest dostępny dla Windows, ale - można pobrać z~internetu opartą na nim przeglądarkę \acro{PDF}: + 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[\texttt{fc-cache}] -- program rejestrujący dla \XeTeX{} fonty +\item[\texttt{fc-cache}] -- program rejestrujący dla \XeTeX-a fonty systemowe lub dostarczane w~dystrybucji \TL{} fonty OpenType; \item[PS\_View] -- nowy program podglądu plików postscriptowych (a~także plików \acro{PDF}), patrz rys.~\ref{fig:psview}. @@ -1545,25 +1551,25 @@ i~Ghostscript; \item[katalog \texttt{support,}] wspomniany już w~części~\ref{sec:tld}, zawiera różne programy, które mogą być użyteczne w~środowisku \TeX-owym (np. edytory/środowiska dla \TeX-a); programy te \emph{nie są} uwzględniane - podczas instalacji samego \TL, należy je więc samodzielnie zainstalować. + podczas instalacji samego \TL, należy je więc zainstalować samodzielnie. \end{description} \subsection{Program Dviout} -Obecne wydanie \TL{} niestety nie oferuje preinstalowanego programu -do podglądu plików \acro{DVI} dla Windows, ale można samodzielnie -zainstalować doskonały \prog{dviout}, autorstwa Toshio Oshimy. -Znajdziemy go w~katalogu \path{support/dviout/}, zawierający również -krótki plik \filename{README} omawiający jak zaistalować i~skonfigurować -\prog{dviout} dla \TL. Przed instalacją zalecamy przeczytać najpierw -informacje tam zawarte. +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 -on-line help programu. +poradniku \emph{on-line} tego programu. -Poniżej zamieszczono listę miejsc, skąd można pobrać programy pomocnicze: +Poniżej zamieszczono listę miejsc, z~których można pobrać programy +pomocnicze: \begin{description} \item[Ghostscript] \url{http://www.cs.wisc.edu/~ghost/} @@ -1574,10 +1580,10 @@ Poniżej zamieszczono listę miejsc, skąd można pobrać programy pomocnicze: \item[NetPBM] --- do przetwarzania i~konwersji plików graficznych możemy użyć alternatywnego dla \textsf{ImageMagick} programu NetPBM (\url{http://netpbm.sourceforge.net/}) -\item[Edytory dla systemu \TeX{}] -- mamy tutaj spory wybór, zależny od - indywidualnych preferencji użytkownika: +\item[Edytory dla systemu \TeX{}] -- spory wybór programów, uwzględniający + indywidualne preferencje użytkownika: \begin{itemize*} - \item \cmdname{GNU Emacs} -- w~wersji zintegrowanej z \textsf{AucTeX} + \item \cmdname{GNU Emacs} -- w~wersji zintegrowanej z~\textsf{AucTeX} dostępny jest w~\TL{} w~katalogu \path{support/} (\url{ftp://alpha.gnu.org/gnu/auctex}) % http://www.gnu.org/software/emacs/windows/ntemacs.html}) @@ -1585,16 +1591,16 @@ Poniżej zamieszczono listę miejsc, skąd można pobrać programy pomocnicze: % (\url{http://www.xemacs.org/}) \item \cmdname{WinShell} -- prosty edytor/shell, dostępny na \TL w~katalogu \dirname{support/WinShell} (\url{http://www.winshell.de}) - \item \cmdname{WinEdt} -- bogaty edytor dla \TeX-a, dostępny jako + \item \cmdname{WinEdt} -- bogaty w~fonkcje edytor dla \TeX-a, dostępny jako \emph{shareware} (\url{http://www.winedt.com}) - \item TeXnicCenter -- kolejny, dosyć bogaty edytor + \item TeXnicCenter -- kolejny, dosyć bogaty w~funkcje 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} + \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{LEd} -- polski edytor dostępny z - \url{http://www.ctan.org/support/LEd} + \item \cmdname{LEd} -- polski edytor, dostępny + z~\url{http://www.ctan.org/support/LEd} \item \cmdname{SciTE} -- edytor dostępny z \url{http://www.scintilla.org/SciTE.html} \end{itemize*} @@ -1613,10 +1619,10 @@ Poniżej zamieszczono listę miejsc, skąd można pobrać programy pomocnicze: Odpowiednikiem uniksowego katalogu domowego użytkownika (HOME) jest w~Windows katalog określany zmienną \verb|%USERPROFILE%|. W~Windows 2000 i~XP jest to zazwyczaj katalog -\verb|C:\Documents and Settings\<nazwa_użytkownika>|, zaś w~Widows Vista +\verb|C:\Documents and Settings\<nazwa_użytkownika>|, zaś w~Windows Vista \verb|C:\Users\<nazwa_użytkownika>|. W~pliku konfiguracyjnym \filename{texmf.cnf} i~bibliotekach \KPS{} znak \verb|~| -jest prawidłowo rozwijany do odpowiedniej zmiennej zarówno w~Windows, jak +jest poprawnie rozwijany do odpowiedniej zmiennej zarówno w~Windows, jak i~w~Unix. \subsection{Rejestr Windows} @@ -1627,13 +1633,13 @@ 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 +domowych użytkowników (patrz~\ref{sec:winhome}), zaś \path{HKLM} -- podkatalogów systemowych (w~katalogu Windows). -Informacje o~ustawieniach systemu mogą być czasem uzyskane ze zmiennych -środowiska, ale inne informacje, np. położenie tzw. skrótów, wymaga odwołania -się do rejestru. Także zapis zmiennych środowiska na stałe wymaga dostępu do -rejestru. +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} @@ -1642,44 +1648,44 @@ rejestru. %%! ją mając na uwadze ogólny sens, w niektórych miejscach doprecyzowując %%! sformułowania. Ale i tak jest, wg mnie, do bani :-) -W nowszych wersjach Windows istnieje wyraźne rozróżnienie pomiędzy +W nowszych wersjach Windows istnieje wyraźne rozróżnienie między zwykłymi użytkownikami i~administratorami, przy czym tylko ci ostatni mają pełną swobodę dostępu do całości systemu. %%! ??? %In practice, though, you could better describe %these classes of users as unprivileged users and normal users: being an %administrator is the rule, not the exception. - Dokonaliśmy wielu starań, aby umożliwić instalację \TL{} także bez - posiadania uprawnień administratora. + Dołożono wielu starań, aby umożliwić instalację \TL{} także osobom bez + uprawnień administratora. -Jeśli osoba instalująca jest administratorem, skróty są tworzone dla +Jeśli osoba instalująca jest administratorem, to skróty są tworzone dla wszystkich użytkowników, także zmienne środowiska są ustawiane dla całego -systemu. W~przeciwnym wypadku skróty i~menu są tworzone tylko dla konkretnego -użytkownika zaś tworzone zmienne środowiska także dotyczą zwykłych +systemu. W~przeciwnym wypadku skróty i~menu są tworzone jedynie dla konkretnego +użytkownika, także też definiowane zmienne środowiska dotyczą zwykłych użytkowników. Jako admistrator możemy zainstalować \TL{} tylko dla -użytkowników; należy wtedy dla uruchomienia \prog{install-tl} użyć parametru +użytkowników; należy wtedy uruchomić \prog{install-tl} z~parametrem \optname{-non-admin}. Bez względu na status użytkownika domyślnym katalogiem głównym instalacji jest katalog w~ramach \verb|%PROGRAMFILES%|. Program instalacyjny zawsze -sprawdza czy ten katalog jest dostępny do zapisu dla aktualnego użytkownika. +sprawdza, czy ten katalog jest dostępny do zapisu dla aktualnego użytkownika. -Problem może pojawić się wtedy, gdy użytkownik instalujący \TL{} nie jest +Problem może się pojawić wtedy, gdy użytkownik instalujący \TL{} nie jest administratorem, a~programy \TeX-owe już są w~ścieżce przeszukiwania. -Wynikowa ścieżka zawiera wtedy ścieżkę systemową, do której dodano ścieżkę -do programów użytkownika, w konsekwencji nowo instalowane programy nie będą -znajdywane. Jako obejście tego problemu program instalacyjny tworzy -skrót do okna z~wierszem poleceń, w~którym ścieżka do nowych programów \TL{} -ma priorytet. W~ten sposób, po uruchomieniu tego skrótu, będzie można -korzystać z~\TL. +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. W~celu obejścia tego problemu program instalacyjny tworzy skrót do +okna z~wierszem poleceń, w~którym ścieżka do nowych programów \TL{} ma +priorytet. W~ten sposób, po uruchomieniu tego skrótu, będzie można korzystać +z~\TL. -%%% Zostawione z poprzedniej wersji tylko w polskiej wersji! +%%% Zostawione z poprzedniej wersji tylko w polskim tłumaczeniu! \subsection{\cmdname{WinShell}}\label{sec:winshell} -Jeśli nie decydujemy się na instalaję rozbudowanego (ale i~bardzo silnego) -edytora Emacs, możemy samodzielnie zainstalować prosty i~łatwy w~obsłudze -edytor WinShell. Znajdziemy go na płytkach w~katalogu +Jeśli nie decydujemy się na instalowanie rozbudowanego (ale i~bardzo +bogatego w~funkcje) edytora Emacs, możemy samodzielnie zainstalować prosty +i~łatwy w~obsłudze edytor WinShell. Znajdziemy go na płytce w~katalogu \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. @@ -1687,17 +1693,17 @@ Dostosowanie do polskiej wersji Windows wymaga, prócz określenia języka dla menu i~komunikatów, użycia menu \verb+Opcje+ (Options) \verb+->+ \verb+Font+ \verb+->+ \verb+Zmień+ i~wyboru w~wyświetlonym oknie \texttt{Skrypt} -napisu \texttt{Europa Środkowa}. Dzięki temu wpisywane za pomocą -prawego klawisza Alt polskie znaki diakrytyczne będą prawidłowo -wyświetlane. +napisu \texttt{Europa Środkowa}. +Dzięki temu poprawnie będą wyświetlane polskie znaki diakrytyczne, +wpisywane za pomocą prawego klawisza Alt. -Aby skonfigurować uruchamianie programów otwieramy menu +Aby skonfigurować uruchamianie programów, otwieramy menu \texttt{Options} \verb+->+ \texttt{Program Calls}. \begin{itemize}\itemsep 0pt -\item W zakładce DVIWin, w~polu ,,exe-file'', należy wpisać +\item W zakładce DVIWin, w~polu ,,exe-file'', wpisujemy \texttt{dviout.exe} (o~ile go wcześniej zaistalowaliśmy). -\item W zakładce Ghostview należy wpisać psv.bat. +\item W zakładce Ghostview wpisujemy psv.bat. %sprawdzić, czy prawidłowo podano %ścieżkę dla gsview32.exe:\\ %\hspace*{1em} \verb+C:\ghostgum\gsview\gsview32.exe+ (dla wersji 3.6 @@ -1706,28 +1712,27 @@ Aby skonfigurować uruchamianie programów otwieramy menu Po wciśnięciu przycisku \texttt{OK} zatwierdzamy zmiany. Instalacja programu ustawia w~Windows skojarzenie plików \texttt{.tex} -z~uruchamianiem \cmdname{WinShell}. Dopóki nie zamierzamy korzystać -z~innego edytora (jak WinEdt lub Emacs) jest to poprawne. +z~uruchamianiem \cmdname{WinShell}. O~ile nie zamierzamy korzystać +z~innego edytora (jak WinEdt lub Emacs), jest to poprawne. -\cmdname{WinShell} posiada pomoc, dostępną po naciśnięciu symbolu -$\textbf{\underbar{?}}$ na belce z~narzędziami. +\cmdname{WinShell} jest wyposażony w~moduł pomocy, dostępnej po +naciśnięciu symbolu $\textbf{\underbar{?}}$ na pasku z~narzędziami. \subsubsection{Użycie plików ,,projektu''} Wielokrotnie mamy do czynienia z~dokumentami składającymi się z~wielu części. Najwygodniej gdy są one zapisane w~odrębnych plikach. \cmdname{WinShell} umożliwia utworzenie pliku projektu (\textit{Project file}), w~którym deklarujemy poszczególne części większego dokumentu. Nazwy -pliku projektu, traktowanego jako główny edytowany plik (\textit{Main file}), -oraz plików części są wyświetlane w~lewym oknie edytora. Dwukrotne kliknięcie -myszą na nazwie pliku pozwala na szybki wybór i~wyświetlenie potrzebnego -pliku w~głównym oknie edytora. Naciśnięcie ikony LaTeX na belce narzędziowej -uruchamia zawsze przetwarzanie głównego pliku, bez względu na to który plik -jest aktualnie wyświetlany. - -Na belce narzędziowej mamy dodatkowe przyciski pozwalające wyłączyć lub +plików projektu: traktowanego jako główny (\textit{Main file}) oraz plików +części są wyświetlane w~lewym oknie edytora. Dwukrotne kliknięcie myszą na +nazwie pliku powoduje jego wyświetlenie w~głównym oknie edytora. Naciśnięcie +ikony LaTeX na belce narzędziowej uruchamia zawsze przetwarzanie głównego +pliku, bez względu na to, który plik jest aktualnie wyświetlany. + +Na belce narzędziowej mamy dodatkowe przyciski, pozwalające wyłączyć lub włączyć wyświetlanie okna projektu (po lewej stronie) i~okna zapisu sesji -(log) -- na dole. Gdy plik projektu nie jest używany, lewą część okna można -zamknąć, wykorzystując całą szerokość ekranu dla edytowanego pliku. +(log) -- u~dołu. Gdy plik projektu nie jest używany, lewą część okna można +zamknąć, uzyskując w~ten sposób całą szerokość ekranu dla edytowanego pliku. \subsubsection{Drukowanie z~\cmdname{WinShell} na drukarce PostScriptowej} \label{winshell:print} @@ -1738,7 +1743,7 @@ wymaga uruchomienia PS\_View. \cmdname{WinShell} pozwala zdefiniować wygodne wywołanie polecenia dvips, które wynik przetwarzania wyśle od razu -do drukarki posiadającej interpreter PostScript. Przykładowo, dla drukarki +do drukarki wyposażonej w~interpreter PostScript. Przykładowo, dla drukarki o~nazwie \texttt{vclw}, postępowanie będzie następujące: \begin{enumerate} \item Deklaracja danej drukarki w programie: @@ -1759,20 +1764,19 @@ o~nazwie \texttt{vclw}, postępowanie będzie następujące: \begin{itemize} \item wybrać menu \texttt{Opcje} \verb+->+ \texttt{Przeglądaj} \verb+->+ \texttt{Dostosuj paski}; -\item w okienku \verb+Kategoria+ wybrać \texttt{Programy użytkownika}; -\item wskazać \texttt{Drukuj} i przeciągnąć go myszą na belkę narzędziową, +\item w~okienku \verb+Kategoria+ wybrać \texttt{Programy użytkownika}; +\item wskazać \texttt{Drukuj} i~przeciągnąć go myszą na belkę narzędziową, umieszczając w~dowolnym miejscu obok innych poleceń; -\item w kolejno wyświetlanym oknie dokonać wyboru: ,,Tylko obrazek'' (Image -only), ,,Tylko tekst'' lub ,,Tekst i~obrazek''; najprościej wybrać -,,Tylko tekst'' i~zatwierdzić guzikiem - \texttt{OK}. +\item w kolejno wyświetlanym oknie dokonać wyboru: ,,Tylko obrazek'' + (\textit{Image only}), ,,Tylko tekst'' lub ,,Tekst i~obrazek''; najprościej + wybrać ,,Tylko tekst'' i~zatwierdzić guzikiem \texttt{OK}. Napis \texttt{Drukuj} ukaże się na belce. (Bardziej wymagający użytkownicy mogą wybrać opcję ,,Tylko obrazek'', następnie ,,Edytuj'' i~skonstruować sobie własną ikonkę.) \end{itemize} \end{enumerate} Uruchamianie polecenia zostało zdefiniowane. Aby drukować bezpośrednio na -drukarce wystarczy teraz nacisnąć guzik z~napisem ,,Drukuj''. +drukarce, wystarczy teraz nacisnąć guzik z~napisem ,,Drukuj''. \subsection{W razie problemów} \label{troubleshooting} @@ -1782,13 +1786,12 @@ plików?} \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ń): + problemów. 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} @@ -1801,7 +1804,7 @@ 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. +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 @@ -1812,9 +1815,9 @@ W ten sposób można skierować zarówno stderr jak i stdout do tego samego pliku. \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. +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} @@ -1823,16 +1826,12 @@ które określono w texmf.cnf. \end{tabular} } -Jeśli sprawdzenia nie wykazały odstępstw, \TeX{} i programy towarzyszące +Jeśli sprawdzenia nie wykazały odstępstw, to \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 +\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}). - %-------------------------- % don't use \Webc so the \uppercase in the headline works. \section{Instrukcja obsługi systemu Web2C} @@ -1888,8 +1887,8 @@ związanego z~\TeX-em. Podstawowymi składnikami systemu są: \noindent Dokładny opis funkcji oraz składni tych programów zawarty jest w~dokumentacji poszczególnych pakietów samego \Webc{}. -Jednak do optymalnego wykorzystania instalacji \Webc{} pomocna będzie -znajomość kilku zasad rządzących całą rodziną programów. +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} @@ -1899,12 +1898,12 @@ Wszystkie programy obsługują standardowe opcje \acro{GNU}: działanie programu. \end{description} -W~celu lokalizacji plików programy \Webc{} używają biblioteki do +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~przypadku, gdy chce się przechowywać +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 @@ -1921,7 +1920,7 @@ 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 +\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). @@ -1931,17 +1930,17 @@ 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 +sprawdza, czy zbudowana wcześniej baza danych (patrz ,,Baza nazw plików'' na stronie~\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, lub nie odnosi się do danego elementu -ścieżki, albo też nie zawiera elementów zgodnych, przeszukiwany jest system +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 +ś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} @@ -1949,10 +1948,10 @@ 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}, nie zostanie on odnaleziony. +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, przeszukiwanie zostanie zatrzymane i~zwrócony +Jeżeli plik się znajdzie, to przeszukiwanie zostanie zatrzymane i~zwrócony zostanie wynik. Ponieważ najprostszym i~najbardziej powszechnym elementem ścieżki jest @@ -1967,7 +1966,7 @@ Jest to opisane w~kolejnych akapitach, w~kolejności w~jakiej ma to miejsce. Trzeba zauważyć, że jeżeli nazwa poszukiwanego pliku jest absolutna lub jawnie względna, tj. zaczyna się od \samp{/} lub \samp{./} -lub \samp{../}, \KPS{} ogranicza się do sprawdzenia czy ten plik istnieje. +lub \samp{../}, to \KPS{} ogranicza się do sprawdzenia, czy ten plik istnieje. \ifSingleColumn \else @@ -2006,28 +2005,29 @@ stronie~\pageref{sec:debugging}). \subsubsection{Pliki konfiguracyjne} \tolerance=3500 -\KPS{} szuka ścieżek przeszukiwania i~innych definicji w~\emph{plikach + \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 -zmienną \envname{TEXMFCNF} (domyślnie taki plik znajduje się w~podkatalogu +przez zmienną \envname{TEXMFCNF} (domyślnie taki plik znajduje się w~podkatalogu \file{texmf/web2c}). 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} +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 jak same programy znajdują plik -\file{texmf.cnf}, skoro nie jest obowiązkowe deklarowanie 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. +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} +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}. @@ -2048,25 +2048,25 @@ znajdziemy za pomocą polecenia \texttt{kpsewhich texmf.cnf}. gdzie \samp{=} i~otaczające spacje są opcjonalne. \item ,,\texttt{\var{zmienna}}'' zawierać może dowolne znaki poza spacją, - \samp{=}, lub \samp{.} (kropką), najbezpieczniej jest jednak używać znaków + \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 posiadać + \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ą. Średnik \samp{;}\ użyty w~,,\texttt{\var{wartość}}'' zamieniany jest na - \samp{:}\ jeżeli systemem operacyjnym jest Unix; umożliwia to posiadanie + \samp{:}\ jeżeli systemem operacyjnym jest Unix; 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 odwoływać się można przed ich zdefiniowaniem. + więc do zmiennych można się odwoływać przed ich zdefiniowaniem. \end{itemize} -Fragment pliku konfiguracyjnego ilustrujący większość opisanych powyżej +Oto fragment pliku konfiguracyjnego, ilustrujący większość opisanych powyżej reguł notacji: \ifSingleColumn \verbatiminput{examples/ex5.tex} @@ -2094,7 +2094,7 @@ Jeżeli ścieżka przeszukiwania największego uprzywilejowania (patrz ,,Źródła \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, dzieje się dalej to samo. +Jeżeli ta wstawiona ścieżka ma dodatkowy dwukropek, to dzieje się dalej to samo. Przykładowo, jeżeli ustawić zmienną środowiskową \tolerance=1500 @@ -2112,47 +2112,47 @@ końcową wartością użytą w~przeszukiwaniu będzie: /home/karl:.:\$TEXMF//tex \end{alltt} -Ponieważ nieużytecznym byłoby wstawiać wartość domyślną w~więcej niż jedno -miejsce, \KPS{} zmienia tylko jeden dodatkowy \samp{:}\ i~pozostawia +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} -Użyteczną cechą jest możliwość rozwijania nawiasów, co oznacza, że np. +Użyteczna jest możliwość rozwijania nawiasów, co oznacza, że np. \verb+v{a,b}w+ rozwija się do \verb+vaw:vbw+. -Możliwe jest zagnieżdżanie nawiasów. -Funkcja ta może być użyta do zaimplementowania różnych hierarchii \TeX-owych +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} znaleźć można następującą definicję: +w~pliku \file{texmf.cnf} można znaleźć następującą definicję: \begin{verbatim} TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN} \end{verbatim} -Używając jej można następnie napisać coś w~rodzaju: +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 przeszukane będą kolejno +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 dla uruchamiania dwóch równoległych struktur \TeX-owych, -jednej ,,zamrożonej'' (np. na \CD), a~drugiej ciągle uaktualnianej nowymi, +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 jest się pewnym, +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ępowany jest przez wszystkie +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{//}, uwzględnione zostaną +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}. @@ -2169,7 +2169,7 @@ konfiguracyjnych. \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 nieUnix-owych +\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; @@ -2177,7 +2177,8 @@ początku lub na końcu ścieżki zastępuje domyślne rozwinięcie ścieżki; \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, trwającego do końca linii; +\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, @@ -2188,13 +2189,13 @@ początku lub na końcu ścieżki zastępuje domyślne rozwinięcie ścieżki; \subsection{Bazy nazw plików} \label{Filename-database} -Dla celów przeszukiwania \KPS{} stara się zminimalizować dostęp do dysku. -Niemniej jednak, w~przypadku instalacji ze zbyt dużą liczbą katalogów, -przeglądanie każdego możliwego katalogu w~poszukiwaniu danego pliku może +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 to zawiera przypisania plików do katalogów. +o~nazwie \file{ls-R}, który zawiera przypisania plików do katalogów. Unika się w~ten sposób potrzeby czasochłonnego przeszukiwania dysku. Drugi plik z~bazą danych -- \file{aliases} -- pozwala na nadawanie @@ -2205,7 +2206,7 @@ plików w~plikach źródłowych. \subsubsection{Baza nazw plików} \label{ls-R} -Jak to wytłumaczono powyżej, plik zawierający główną bazę nazw +Jak już wspomniano powyżej, 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 @@ -2245,7 +2246,7 @@ intensywnie w~skryptach \samp{mktex...} tej dystrybucji). > \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{-{}-}, i~dozwolony jest każdy jednoznaczny skrót. +\samp{-}, jak i~od \samp{-{}-}, a~dozwolony jest każdy jednoznaczny skrót. \KPS{} traktuje każdy argument nie będący parametrem jako nazwę pliku i~zwraca pierwszą odnalezioną nazwę. @@ -2271,10 +2272,10 @@ Ważniejsze parametry opisane są poniżej. \item[\texttt{-{}-mode=\var{napis}}]\mbox{}\\* Ustaw nazwę trybu na ,,\texttt{\var{napis}}''; dotyczy to jedynie szukania fontów \samp{gf} oraz \samp{pk}. - Brak jest wartości domyślnej -- odnaleziony zostanie dowolny + 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 + 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}. @@ -2293,7 +2294,7 @@ Ważniejsze parametry opisane są poniżej. Pokazuje ścieżkę używaną do poszukiwania plików typu ,,\texttt{\var{nazwa}}''. Użyte może być zarówno rozszerzenie (\samp{.pk}, \samp{.vf}, etc.), jak - i~nazwa pliku, tak jak w~przypadku parametru \samp{-{}-format}. + i~nazwa 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} @@ -2306,7 +2307,7 @@ Ważniejsze parametry opisane są poniżej. \subsubsection{Przykłady użycia} \label{SExamplesofuse} -Przyjrzyjmy sie teraz jak działa \KPS{}. +Przyjrzyjmy sie teraz, jak działa \KPS{}. \begin{alltt} > \Ucom{kpsewhich article.cls} @@ -2315,9 +2316,9 @@ Przyjrzyjmy sie teraz jak działa \KPS{}. Szukamy 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 +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 +Podobnie wszystkie poniższe pliki odnajdowane są bez\-pro\-ble\-mo\-wo dzięki swoim jednoznacznym rozszerzeniom: \begin{alltt} > \Ucom{kpsewhich array.sty} @@ -2341,7 +2342,7 @@ dzięki swoim jednoznacznym rozszerzeniom: Pliki czcionek bitmapowych typu \file{.pk} używane są przez sterowniki, takie jak \cmdname{dvips} % ??? dvips to chyba nie przeglądarka --- czy \cmdname{xdvi}. % w oryg. było display programs like dvips... -W~tym wypadku nie zostaną zwrócone żadne rezultaty przeszukiwania, ponieważ +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} @@ -2353,13 +2354,13 @@ w~systemie brak gotowych wygenerowanych czcionek \samp{.pk} Computer Modern 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 rezultat. +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}), widzimy, że taka czcionka nie jest dostępna -w~naszej instalacji. +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}). @@ -2386,7 +2387,7 @@ wyraźnie jaki typ jest wymagany dla pliku \end{alltt} Następnie przyjrzymy się bliżej plikom pomocniczym fontów Times z~kolekcji -URW. W~standardzie nazewnictwa fontów posiadają one prefiks \samp{utm}. +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} @@ -2424,15 +2425,15 @@ Times Roman \file{utmr8a.pfb} w~drzewie katalogów \file{texmf}: \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ś -zawieruszyła się zła wersja jakiegoś pliku; \cmdname{kpsewhich} pokaże tylko +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 radzi sobie -z~odniesieniami do plików. Aby dało się to wykonywać w~wygodny sposób, +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 @@ -2448,39 +2449,39 @@ z~odniesieniami do plików. Aby dało się to wykonywać w~wygodny sposób, (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, -potrzebując wykryć przyczyny błędów, prawdopodobnie zawsze używać -będziesz tych poziomów. +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~wypadku gdy plik nie zostanie odnaleziony, widać, w~których katalogach -program szukał danego pliku, dzięki czemu można się zorientować w~czym +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 wybrać można przy użyciu +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 jest +\textbf{Uwaga dla użytkowników Windows:} w~systemie tym niełatwo przekierować komunikaty programu do pliku. Do celów diagnostycznych -można w~tym celu ustawić chwilowo zmienne (w~oknie DOS/CMD): +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 co następuje: +który zawiera: \begin{verbatim} \documentclass{article} \begin{document} Hello World! \end{document} \end{verbatim} -Ten mały plik używa jedynie fontu \file{cmr10}. Przyjrzyjmy się jak +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} @@ -2509,7 +2510,7 @@ programu \cmdname{dvips} (ścieżki fontowe) oraz z~rozwijaniem elementu 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} -(dla optymalizacji szukania plików), następnie plik \file{aliases}, +(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 @@ -2528,8 +2529,8 @@ p +bakomaextra.map 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 PostScript-owych; więcej szczegółów odnośnie -PostScript-owych plików przemapowań fontów można znaleźć w~ostatniej części +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: @@ -2550,7 +2551,7 @@ potem szuka pliku prologu \file{texc.pro}. %(patrz rys.~\ref{fig:dvipsdbgb}). \fi -Po znalezieniu szukanego pliku, \cmdname{dvips} podaje datę i~czas +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: @@ -2560,10 +2561,9 @@ Defining font () cmr10 at 10.0pt Font cmr10 <CMR10> is resident. \end{alltt} Teraz trwa poszukiwanie pliku \file{cmr10.tfm}, który zostaje znaleziony, -a~następnie \cmdname{dvips} powołuje się na kilka innych plików startowych +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): +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//: @@ -2600,7 +2600,7 @@ Najważniejszymi zmiennymi są: % \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~przypadku korzystania z~pakietu \PiCTeX{}. + 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 @@ -2608,8 +2608,8 @@ Najważniejszymi zmiennymi są: % \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 okazać - się zbyt mała, np. w~wypadku obszernej książki zawierającej liczne + 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} % @@ -2619,17 +2619,22 @@ 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} +\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 \CD{} w~katalogu +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~\CD{} -\TL{} (najlepiej jest wykonać instalację podstawową, bez wybierania +\TL{} (najlepiej wykonać instalację podstawową, bez wybierania binariów systemowych). \subsection{Warunki wstępne} @@ -2640,11 +2645,11 @@ 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. -Prawidłowo powinny pracować \cmdname{gcc}-2.7.*, \cmdname{flex}-2.4.7 +Poprawnie powinny pracować \cmdname{gcc}-2.7.*, \cmdname{flex}-2.4.7 i~\acro{GNU}\,\cmdname{make}-3.72.1 lub nowszy. -Istnieje możliwość pracy z~innymi kompilatorami C i~programami +Można też korzystać z~innych kompilatorów C i~programów \cmdname{make}, wymaga to jednak dobrego zrozumienia zasad tworzenia -programów Unixowych, aby móc poradzić sobie z~ewentualnymi problemami. +programów uniksowych, aby móc poradzić sobie z~ewentualnymi problemami. %W~wyniku wykonania polecenia \texttt{uname} powinniśmy %otrzymać jakąś rozsądną wartość. @@ -2652,10 +2657,10 @@ programów Unixowych, aby móc poradzić sobie z~ewentualnymi problemami. 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 zdecydować się, gdzie będzie główny katalog instalacji, +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 wykorzystana -przy instalowaniu głównego drzewa \TeX-owego. +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} @@ -2663,7 +2668,7 @@ Uruchomić \textsf{configure} z~linii poleceń: \end{alltt} Katalog ,,prefix'' to ten, w~którym zainstalowane zostało główne drzewo -\TeX-owe. Zostanie wykorzystany następujący układ katalogów +\TeX-owe. Zostanie użyty następujący układ katalogów (\verb|$TEXDIR| oznacza wybrany powyżej katalog): \noindent @@ -2680,32 +2685,32 @@ Katalog ,,prefix'' to ten, w~którym zainstalowane zostało główne drzewo 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~przypadku wybrania innego katalogu, trzeba wyszczególnić ten katalog +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}), w~wywołaniu -skryptu \cmdname{configure} należy użyć parametru +(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 +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ć +należy napisać: \begin{alltt} > \Ucom{make world} \end{alltt} i~\ldots zaparzyć sobie kawę. -Mogłoby też być użyteczne zapisanie w~pliku \texttt{.log} całego procesu -kompilacji: +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 +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: @@ -2733,7 +2738,7 @@ odpowiednie nazwy podkatalogów, tj.\ Patrz część~\ref{sec:postinstall} (str.~\pageref{sec:postinstall}). Jeśli zechcesz udostępnić skompilowane przez siebie programy, skontaktuj -się z~nami; chętnie umieścimy je na stronie \TL. +się z~nami (\url{tex-live@tug.org}); chętnie umieścimy je na stronie \TL. %\end{comment} %-------------------------- @@ -2744,65 +2749,65 @@ Niniejsza edycja \TL{} została opracowana pod kierownictwem Karla Berry'ego, przy głównym współudziale: \begin{itemize*} -\item angielskiej, niemieckiej, holenderskiej i polskiej grup \TeX-owych - (odpowiednio \acro{TUG}, \acro{DANTE} e.V., \acro{NTG}, i~\acro{GUST}), które +\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} (w~szczególności Robina Fairbairnsa, Jima Hef{}ferona i~Rainera Sch\"opfa), który dystrybuuje obrazy \TL{} i~udostępnia wspólną infrastrukturę służącą aktualizacji pakietów, od której zależy \TL{}; -\item Petera Breitenlohnera i zespołu \eTeX, którzy stworzyli stabilną +\item Petera Breitenlohnera i~zespołu \eTeX, którzy stworzyli stabilną podstawę przyszłych wersji \TeX-a (Peter dodatkowo służy nieustanną pomocą w~wykorzystaniu narzędzi autotools w~\TL); \item Thomasa Essera, autora wspaniałego \teTeX-a, bez którego \TL{} z~całą pewnością by nie powstał, i~którego stała - pomoc umożliwiła rozwój tej dystrybucji; + 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; \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 +\item \Thanh{}a, Martina Schr\"odera i~zespołu pdf\TeX-a za ciągłe ulepszanie możliwości \TeX-a; -\item Hartmuta Henkela, za znaczny udział w~rozwoju pdf\TeX, Lua\TeX{} +\item Hartmuta Henkela, mającego znaczny udział w~rozwoju pdf\TeX, Lua\TeX{} i~innych programów; -\item Taco Hoekwatera, za wznowienie rozwoju MetaPosta i~prace nad - (Lua)\TeX-em, także za pomoc w~integracji \ConTeXt\ w~\TL; +\item Taco Hoekwatera, który wznowił rozwój MetaPosta i~prace nad + (Lua)\TeX-em, jak też pomógł w~integracji \ConTeXt\ w~\TL; \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, za dostarczenie programów dla Windows, które pochodzą +\item Akira Kakuto, który dostarczył programy dla Windows, pochodzące z~dystrybucji \acro{W32TEX} - (\url{http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/}), ale są + (\url{http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/}), stale dostosowywane i~aktualizowane dla potrzeb \TL; -\item Jonathana Kew i firmy \acro{SIL}, za poważną nową ścieżkę - rozwojową, którą jest Xe\TeX{}, oraz za wysiłek włożony w~zintegrowanie - programu z~\TL, jak również za początkowe prace nad instalatorem dla +\item Jonathana Kew i firmy \acro{SIL}, za zainicjowanie nowej ścieżki + rozwojowej, którą jest Xe\TeX{}, oraz za wysiłek włożony w~zintegrowanie + tego programu z~\TL, jak również zapoczątkował prace nad instalatorem dla Mac\TeX; -\item Dicka Kocha, za pielęgnację Mac\TeX-a (\url{http://tug.org/mactex}) - w~ścisłym połączeniu z~\TL i~bardzo sympatyczną współpracę; -\item Reinharda Kotuchy, za ważny udział w~stworzeniu nowej infrastruktury - i~programu instalacyjnego dla \TL{} 2008, upór w~ujednoliceniu działania - \TL{} w~Windows i~Unix, jak również za skrypt - \texttt{getnonfreefonts} i~za wiele innych prac; -\item Siep Kroonenberg, także za udział w~stworzeniu nowej infrastruktury - i~programu instalacyjnego dla \TL{} 2008 (szczególnie dla Windows) - oraz za ogrom pracy włożonej w~aktualizację tej dokumentacji; +\item 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{} 2008, uparcie dążącego do ujednolicenia + działania \TL{} w~Windows i~Unix, jak 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{} 2008 (szczególnie dla + Windows) oraz włożyła ogrom pracy w~aktualizację tej dokumentacji; \item Petra Ol\shac{}\aac{}ka, który koordynował i~sprawdzał przygotowanie czeskich i~słowackich pakietów; -\item Toshio Oshimy, za jego przeglądarkę \cmdname{dviout} dla Windows; -\item Manuela P\'egouri\'e-Gonnarda, za pomoc w~aktualizacji pakietów - i~prace nad \cmdname{tldoc}. +\item 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{tldoc}. \item Fabrice'a Popineau, który pierwszy stworzył wersje oprogramowania dla Windows; \item Norberta Preininga, głównego architekta infrastruktury i~programu - instalacyjnego \TL{} 2008, także za aktualizację pakietów, koordynowanie - (wraz z~Frankiem K\"usterem) debianowej wersji \TL{}, oraz za wiele - sugestii ulepszeń; -\item Sebastiana Rahtza, za stworzenie \TL{} i~kierowanie projektem przez + instalacyjnego \TL{} 2008, a~przyczynił się też do aktualizacji pakietów, + koordynowania (wraz z~Frankiem K\"usterem) debianowej wersji \TL{}, + i~przedstawił wiele sugestii ulepszeń; +\item Sebastiana Rahtza, który stworzył \TL{} i~kierował projektem przez wiele lat; -\item Vladimira Volovicha, za wyjątkową pomoc w~rozwiązywaniu problemów - przenośności i~szczególnie za umożliwienie dołączenia \cmdname{xindy}; +\item 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); @@ -2838,7 +2843,7 @@ Klaus H\"oppner (niemiecki), Petr Sojka i~Jan Busa (czeski\slash słowacki), Boris Veytsman (rosyjski), Staszek Wawrykiewicz (polski). -Na stronie \url{http://tug.org/texlive/doc.html} znajdziemy ewentualne +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 @@ -2859,26 +2864,26 @@ 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 taki był wprawdzie zbyt ambitny, ale zrodził nie tylko bardzo +Projekt taki 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 +\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 rezultatów wprowadzenia tego standardu mogłaby +jednym z~oczekiwanych wyników wprowadzenia tego standardu mogłaby być modelowa struktura na \CD. Niniejszy \CD{} jest 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ć +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 nowego \CD, opartego na standardzie \TDS i~zorientowanego na systemy Uniksowe, rozpoczął się jesienią 1995 roku. Szybko zdecydowaliśmy się na wykorzystanie \teTeX-a autorstwa Thomasa Essera, ponieważ -oferował on wsparcie dla wielu platform i~został zaprojektowany z~myślą +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ł @@ -2890,28 +2895,28 @@ 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, -wykorzystując nową wersję te\TeX-a i~nową wersję \Webc{} (7.3). -Wtedy to też zainaugurowano kompletną dystrybucję dla Windows. +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óły zawartości pakietów zostały -zapisane w~plikach XML. +zaktualizowano setki pakietów. Szczegółową zawartość pakietów +zapisano w~plikach XML. Główną zmianą w~\TeX\ Live5 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, -ale nadal bardzo prosimy o~zgłaszanie zauważonych pomyłek. +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 +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 także przygotowywał odpowiedni plik +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. +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 @@ -2926,7 +2931,7 @@ 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}~-- korzystały + 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 @@ -2935,11 +2940,11 @@ na \DVD{} i~dwóch płytkach \CD. Ponadto: 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; + 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, wykorzystywane przez programy \cmdname{dvips}, +\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 @@ -2956,7 +2961,7 @@ na \DVD{} i~dwóch płytkach \CD. Ponadto: \subsection{Edycja 2004} -Jak przy każdej kolejnej wersji, w~2004 roku uaktualniono wiele pakietów +Jak w~każdej kolejnej wersji, uaktualniono w~2004 roku wiele pakietów i~programów. Poniżej wymieniamy najbardziej istotne zmiany. \begin{itemize} @@ -2999,24 +3004,24 @@ metody wyszukiwania plików. \item Pomocnicze skrypty wykonywalne, niezależne od platformy i~zwykle uruchamiane w~sposób automatyczny, są obecnie umieszczone w~nowym podkatalogu \dirname{scripts} w~ramach \dirname{texmf*}. -Znajdywane są poleceniem \verb|kpsewhich -format=texmfscripts|. +Znajdowane są poleceniem \verb|kpsewhich -format=texmfscripts|. Programy korzystające z tych skryptów mogą wymagać modyfikacji. Patrz \CDref{texmf-doc/doc/english/tds/tds.html\#Scripts} {\texttt{texmf-doc/doc/english/tds/tds.html\#Scripts}}. \item Prawie wszystkie formaty traktują obecnie większość znaków jako jawnie ,,wyświetlalne'' (\emph{printable}), nie zaś, jak było dotychczas, -konwertowane na \TeX-ową notację \verb|^^|. Możliwe jest to dzięki domyślnemu +konwertowane na \TeX-ową notację \verb|^^|. Jest to możliwe dzięki domyślnemu wczytywaniu tablicy przekodowań \filename{cp227.tcx}. Dokładniej, znaki o~kodach 32--256, HT, VT oraz FF są traktowane 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ść była wprowadzona w~\TL\,2003, ale +na Omedze. Podobna domyślna właściwość występowała w~\TL\,2003, ale obecnie 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.html\#TCX-files}}. -(Warto wspomnieć, że wczytując Unicode \TeX{} może w~komunikatach błędów +(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? @@ -3088,7 +3093,7 @@ Więcej informacji zawiera podręcznik Web2C: \OnCD{texmf/doc/web2c}. \url{http://www.olsak.net/enctex.html}). \item Dostępny jest nowy program Aleph, który łączy cechy \eTeX\ i~\OMEGA. - Póki co, dokumentacja jest znikoma (\OnCD{texmf-dist/doc/aleph/base} + Na razie dokumentacja jest znikoma (\OnCD{texmf-dist/doc/aleph/base} oraz \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph}). Format bazujący na \LaTeX-u dla programu Aleph nazwano \textsf{lamed}. @@ -3100,28 +3105,28 @@ 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 Beccari, ograniczono +\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://www.ctan.org/tex-archive/fonts/greek/cb}). -\item Usunięto program \cmdname{oxdvi}; jego funkcje obsługuje -obecnie \cmdname{xdvi}. +\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 są już dostępne. -W~zupełności wystarcza użycie w~wierszu poleceń opcji \optname{-ini}. +\cmdname{tex}, \cmdname{mf} i~\cmdname{mpost}, nie są już dostępne -- +w~zupełności wystarcza użycie w~wierszu poleceń opcji \optname{-ini}. -\item Dystrybucja nie zawiera binariów dla platformy \textsf{i386-openbsd} +\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ży ustawić zmienną systemową \envname{LD\_LIBRARY\_PATH}, aby uruchomić programy \pkgname{t1utils}. -Binaria były kompilowane w~C++, ale w~tym systemie brak jest standardowego -położenia bibliotek uruchomieniowych. Fakt ten był już wcześniej znany, -ale nie był dotychczas udokumentowany. Z~kolei dla systemu +Binaria były kompilowane w~C++, ale w~tym systemie brakuje 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 jest obecność bibliotek \acro{MIPS}pro 7.4. \end{itemize} @@ -3129,7 +3134,7 @@ ale nie był dotychczas udokumentowany. Z~kolei dla systemu \subsection{Edycja 2005} Edycja ta przyniosła, jak zwykle, mnóstwo aktualizacji pakietów -i~programów. Struktura dystrybucji ustabilizowała się, niemniej jednak +i~programów. Struktura dystrybucji ustabilizowała się, niemniej pojawiło się nieco zmian w~konfiguracji: \begin{itemize} @@ -3147,21 +3152,21 @@ pojawiło się nieco zmian w~konfiguracji: się koniecznym przeniesienie własnych wersji \filename{fmtutil.cnf} i~\filename{updmap.cfg} w~odpowiednie miejsca. Inną możliwością jest przedefiniowanie \envname{TEXMFCONFIG} lub \envname{TEXMFSYSCONFIG} - w~pliku texmf.cnf. W~każdym przypadku położenie tych plików i~przypisania + 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 przy produkowaniu wynikowego pliku DVI +\item W~wydaniu z~poprzedniego roku przy 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~tym roku zarzuciliśmy to rozwiązanie, którego celem było zapewnienie - kompatybilności. Z~tego powodu będą musiały ulec zmianie te Twoje dokumenty, - które używają \verb|\ifx\pdfoutput\undefined| do sprawdzania czy plik + kompatybilności. Z~tego powodu będziesz zmuszony zmienić te Twoje dokumenty, + które używały \verb|\ifx\pdfoutput\undefined| do sprawdzania, czy plik wynikowy ma być w~formacie PDF. Możesz 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~poprzedniego roku zmieniliśmy większość formatów tak, aby +\item W~wydaniu z~poprzedniego roku zmieniliśmy 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|^^|), @@ -3173,7 +3178,8 @@ latex --translate-file=empty.tcx twojplik.tex \item Dołączono nowy program \cmdname{dvipdfmx}, służący do konwersji DVI do PDF. Program jest aktywnie pielęgnowaną aktualizacją programu - \cmdname{dvipdfm}, który wciąż jest dostępny, ale nie jest już polecany. + \cmdname{dvipdfm}, który wciąż jest dostępny, ale nie jest już jednak + polecany. \item Nowe programy \cmdname{pdfopen} i~\cmdname{pdfclose} pozwalają na przeładowanie plików PDF w~Adobe Acrobat Reader, bez konieczności ponownego @@ -3206,28 +3212,28 @@ Podkatalogi te mają nazwę zgodną z~zastosowanym podczas generowania 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ć +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{\%\&}. -Oczywiście, jak zwykle, w~okresie od ostatniego wydania wykonano setki innych +Oczywiście, jak zwykle, w~okresie od ostatniego wydania opracowano 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 zamieszczono na stronie +umożliwia standardowy interfejs www, a~jego adres zamieszczono na stronie \url{http://tug.org.pl/texlive}. Mimo iż nie widać efektów tej zmiany w końcowej dystrybucji, mamy nadzieję, -że będzie to stabilne repozytorium oprogramowania dla rozwoju \TL{} -w~nadchodzących latach. +ż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}). W wyniku tego znacznie -wzrosło zainteresowanie \TL, szczególnie wśród dystrybutorów -\acro{GNU}/Linux-a. (W \TL{} zdefiniowano w przybliżeniu równoważny, nowy +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 wszyscy skorzystają. +których skorzystają wszyscy. \medskip \noindent Końcowa uwaga, dotycząca przeszłości: wszystkie wydania \TL{}, wraz @@ -3251,8 +3257,8 @@ W~tym wydaniu pojawił się nowy ,,silnik'', Lua\TeX\ dotyczących składu, udostępnia on doskonały język skryptowy do zastosowania zarówno w~dokumentach \TeX-owych, jak i~poza nimi. -Wsparcie dla Windows i~platform opartych na Unix zostało obecnie znacznie -bardziej zunifikowane. W~szczególności większość skryptów perlowych i~Lua +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). @@ -3261,7 +3267,7 @@ 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} +Wraz z pojawieniem się \cmdname{tlmgr} niektóre funkcje \cmdname{texconfig} zostały zablokowane (edycja plików konfiguracyjnych formatów i~wzorców przenoszenia). @@ -3285,24 +3291,24 @@ na rozwiązanie tych sprzeczności. Usunięto format \pkgname{platex}, by uniknąć konfliktu nazwy z~używanym od wielu lat japońskim pakietem \pkgname{platex}; pakiet \pkgname{polski} (czyli -dawny \pkgname{platex}) jest obecnie wystarczającym wsparciem polonizacyjnym +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łatwi ich aktualizację. +co ułatwia ich aktualizację. -Włączono także do tego wydania ostatnie zmiany dokonane przez +Do tego wydania włączono także ostatnie zmiany dokonane przez Donalda Knutha (tzw. ,,\TeX\ tuneup of 2008''); patrz: \url{http://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf}. \subsection{Przyszłe wersje} -\emph{Niniejsza dystrybucja nie jest doskonała!} Planujemy kontynuowanie +\emph{Niniejsza dystrybucja nie jest doskonała!} Planujemy kontynuować 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 +poświęcających na to wiele 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}. |