diff options
Diffstat (limited to 'Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.tex')
-rw-r--r-- | Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.tex | 623 |
1 files changed, 360 insertions, 263 deletions
diff --git a/Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.tex b/Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.tex index 8a2284eb44d..6cb1b183711 100644 --- a/Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.tex +++ b/Master/texmf-dist/doc/texlive/texlive-pl/texlive-pl.tex @@ -56,7 +56,7 @@ \fi \title{% - {\huge \textit{Przewodnik \protect\TL{} 2022}} + {\huge \textit{Przewodnik \protect\TL{} 2023}} } \author{Karl Berry\\[2mm] @@ -65,7 +65,7 @@ \url{https://tug.org/texlive/} } -\date{Marzec 2022 r.} +\date{Luty 2023 r.} \begin{document} \maketitle @@ -78,12 +78,12 @@ \subsection{\protect\TeX\protect\ Live i \protect\TeX\protect\ Collection} Ten dokument opisuje oprogramowanie \TL{} -- -dystrybucję \TeX-a wraz z~programami pomocniczymi, dostępną dla \GNU/Linux, -różnych wersji Unix, \MacOSX oraz Windows. +dystrybucję \TeX-a wraz z~programami pomocniczymi, dostępną dla systemów \GNU/Linux, +różnych wersji Unix, \macOS\ oraz Windows. -\TL{} można ściągnąć z~sieci bądź otrzymać na płytce \DVD \TK{}, którą otrzymują członkowie odpowiedniej Grupy Użytkowników Systemu \TeX{}. -Część \ref{sec:tl-coll-dists} omawia pokrótce zawartość tej płytki. -Zarówno \TL{}, jak i \TK{} powstały dzięki zbiorowemu wysiłkowi Grup użytkowników \TeX-a. +\TL{} można ściągnąć z~sieci bądź otrzymać na płytce \DVD \TK{}, którą otrzymują członkowie krajowej Grupy Użytkowników Systemu \TeX{}. +Część \ref{sec:tl-coll-dists} omawia pokrótce zawartość tej płytki \DVD. +Zarówno \TL{}, jak i \TK{} powstały dzięki zbiorowemu wysiłkowi różnych grup użytkowników \TeX-a. W~tym dokumencie omówimy głównie samą dystrybucję \TL. \TL{} zawiera pliki wykonywalne programów: \TeX{}, \LaTeXe{}, \ConTeXt, @@ -107,19 +107,20 @@ np. w~artykule {\it Przewodnik po systemie \TeX\/}: \label{sec:os_support} \TL{} zawiera oprogramowanie dla wielu platform uniksowych, -w~tym \GNU/Linux, \MacOSX i~Cyg\-win. Dołączone źródła mogą być skompilowane +w~tym \GNU/Linux, \macOS\ i~Cyg\-win. Dołączone źródła mogą być skompilowane na platformach, dla których nie udostępniamy plików binarnych. %Załączone pliki źródłowe pozwalają też na jego instalację na platformach innych systemów operacyjnych i~kompilację %samych programów. Spośród systemów Windows obsługiwane jest Windows~7 i~wersje późniejsze. W~Windows Vista \emph{również powinien} zadziałać, ale \TL{} nie może już być instalowany w~systemach Windows XP i~wcześniejszych. -\TL{} nie zawiera osobnych binariów dla 64-bitowych wersji Windows, programy 32-bitowe -działają w~obu wersjach. W \url{https://tug.org/texlive/windows.html} omówiono, jak -dodać binaria 64-bitowe. +\TL{} zawiera binaria dla 64-bitowych wersji Windows. %programy 32-bitowe +%działają w~obu wersjach. +%W \url{https://tug.org/texlive/windows.html} omówiono, jak +%dodać binaria 64-bitowe. W części \ref{sec:tl-coll-dists} omówiono alternatywne dystrybucje, -przeznaczone dla Windows oraz \MacOSX. +przeznaczone dla Windows oraz \macOS. \subsection{Podstawy instalacji \protect\TL{}} \label{sec:basic} @@ -139,11 +140,11 @@ tego dokumentu (str.~\pageref{sec:install}), poniżej zaś informacja w skrócie \begin{itemize*} \item Skrypt instalacyjny dla systemu Unix nosi nazwę \filename{install-tl} zaś dla systemów Windows należy użyć \filename{instal-tl-windows}. Program instalacyjny będzie działał w~trybie graficznym -z~opcją \code{-gui} (co jest trybem domyślnym dla Windows i~starszego MacOSX) lub w~trybie tekstowym z~opcją -\code{-gui=text} (co jest trybem domyślnym dla pozostałych platform). +z~opcją \code{-gui} (tryb domyślny dla Windows) lub w~trybie tekstowym z~opcją +\code{-gui=text} (tryb domyślny dla pozostałych platform). \item Jednym z~instalowanych programów jest \prog{tlmgr} (menedżer \TL{}), -który można uruchomić zarówno w~trybie tekstowym jak i~graficznym. Pozwala +który można uruchomić zarówno w~trybie tekstowym jak i~graficznym (\GUI{}). Pozwala on doinstalować lub usunąć pakiety, aktualizować je z~sieci, a także wykonywać różne czynności konfiguracyjne. @@ -155,7 +156,7 @@ wykonywać różne czynności konfiguracyjne. Zgodnie z~naszą najlepszą wiedzą, główne programy \TeX-owe są (i~zawsze były) nadzwyczaj odporne. Jednak mimo dokładania najwyższej -staranności, inne programy wspierające, zawarte w~\TeX\ Live, nie +staranności, inne programy wspierające, zawarte w~\TL\ nie zawsze osiągają ten sam poziom. Jak zawsze, należy być ostrożnym przy uruchamianiu programów z~danymi pochodzącymi z~niepewnych źródeł. Dla zwiększenia stopnia @@ -176,7 +177,6 @@ I~na koniec: \TeX\ (oraz towarzyszące mu programy) mogą, przy przetwarzaniu dokumentów, tworzyć pliki. Własność ta jest na wiele różnych sposobów podatna na nadużycia. Także w~tych przypadkach, przetwarzanie nieznanych dokumentów w~nowych podfolderach jest najlepszym znanym sposobem zabezpieczenia. -%tutaj jest dodany cały akapit Innym elementem dbałości o~bezpieczeństwo jest upewnienie się, że pobrany materiał nie został zmieniony po utworzeniu. Program \prog{tlmgr} (punkt~\ref{sec:tlmgr}) @@ -203,41 +203,24 @@ Oto lista źródeł pomocy, w~kolejności przez nas rekomendowanej: \item [CTAN] Jeśli szukasz konkretnego pakietu, fontu, programu itp. powinieneś odwiedzić \CTAN{} (\url{https://ctan.org}). Jest to ogromny zbiór wszystkich elementów związanych z \TeX-em. Wpisy w katalogu informują również, czy dany pakiet jest dostępny dla \TL{} czy dla MiK\TeX-a. -%\item [\TeX{} FAQ] The \TeX{} FAQ is a compendium of answers to all -%sorts of questions, from the most basic to the most arcane. It is -%available on the Internet through \url{https://texfaq.org}. - \item [\TeX{} FAQ] \TeX-owy FAQ jest obszernym zbiorem odpowiedzi na wiele pytań, od najprostszych do najbardziej zaawansowanych. Znajdziesz go w Internecie na stronie \url{https://texfaq.org}. -%Na \TL{} znajdziesz go w~katalogu -%\OnCD{texmf-dist/doc/generic/FAQ-en/}, -%a~w~sieci znajdziesz go tu: \url{https://texfaq.org}. Proponujemy -% najpierw zajrzeć właśnie tam. Serwis {FAQ} uruchomiono też -%w~języku polskim: \url{http://www.gust.org.pl/faq}. - - -%\item [\TeX{} Zasoby internetowe] Jeśli poszukujemy konkretnego pakietu, fontu, -%programu itp., to polecamy stronę \url{https://tug.org/interest.html}. Znajdziemy tam wiele odnośników związanych z \TeX-em, w szczególności do licznych książek, podręczników i artykułów na temat wszystkich aspektów systemu. \item [\TeX{} Zasoby internetowe] Strona \url{https://tug.org/interest.html} zawiera wiele odsyłaczy, w~szczególności do książek, podręczników i~artykułów poświęconych wszelkim aspektom pracy z~systemem \TeX. \item [Archiwa pomocy] Główne fora wsparcia użytkowników \TeX-a to dla \LaTeX-a -\url{https://latex.org/}, %gdzie można zadać pytanie lub poszukać na nie odpowiedzi +\url{https://latex.org/}, \url{https://tex.stackexchange.com} (strona typu pytanie-odpowiedź), grupa dyskusyjna Usenet \url{news:comp.text.tex}, czy lista dyskusyjna \email{texhax@tug.org}. - -%Pomocy w rozwiązaniu tex-owego problemu możemy szukać na stronach % użytkowników \TeX-a -%\url{https://latex-community.org/}, \url{https://tex.stackexchange.com}, -% grupy Usenet \url{news:comp.text.tex} czy liście dyskusyjnej \email{texhax@tug.org} - -Archiwa ostatnich dwóch list dyskusyjnych, -zawierające pytania i odpowiedzi zbierane przez wiele lat znajdziemy po adresem: -\url{https://groups.google.com/group/comp.text.tex/topics} oraz -\url{https://tug.org/mail-archives/texhax}. Nie zaszkodzi też -skorzystać z~wyszukiwarki, np. \url{https://www.google.com}. +% +%Archiwa ostatnich dwóch list dyskusyjnych, +%zawierające pytania i odpowiedzi zbierane przez wiele lat znajdziemy po adresem: +%\url{https://groups.google.com/group/comp.text.tex/topics} oraz +%\url{https://tug.org/mail-archives/texhax}. Nie zaszkodzi też +%skorzystać z~wyszukiwarki, np. \url{https://www.google.com}. \item [Wysyłanie pytań] Jeśli nie znajdziemy rozwiązania problemu wśród tematów poruszanych na listach dyskusyjnych, możemy, poprzez ich strony internetowe, wysłać swoje pytanie do \url{https://latex-community.org/} i~\url{https://tex.stackexchange.com/}, @@ -248,10 +231,6 @@ Przed wysłaniem zapytania \emph{należy} zapoznać się z~poradami dotyczącymi formułowania pytań, zawartymi w~FAQ: \url{https://texfaq.org/FAQ}. Zastosowanie się do tych zasad zwiększy szanse na otrzymanie użytecznej odpowiedzi. -%Warto wspomnie� stron� \LaTeX{} Community -%(\url{https://www.latex-community.org/}), forum -%\url{https://www.latex-community.org/forum/} oraz -%\TeX\ StackExchange (\url{https://tex.stackexchange.com/}). Polscy użytkownicy mają do dyspozycji listę dyskusyjną GUST (polskiej Grupy Użytkowników Systemu \TeX); informacje o niej znajdziemy na stronie \url{http://www.gust.org.pl}. @@ -278,10 +257,12 @@ systemu \TeX! Omówimy teraz zawartość dystrybucji \TL{}, a~także \TK{} -- płytki \DVD, w~skład której wchodzi \TL. -\subsection{The \protect\TeX\protect\ Collection: \protect\TL, pro\protect\TeX{}t, Mac\protect\TeX} -\label{sec:tl-coll-dists} +%\subsection{The \protect\TeX\protect\ Collection: \protect\TL, pro\protect\TeX{}t, Mac\protect\TeX} +%\label{sec:tl-coll-dists} -Płytka \TK{} \DVD{} zawiera: +\subsection{Kolekcje \protect\TeX-a: \protect\TL, Mac\protect\TeX, MiK\protect\TeX, CTAN} +\label{sec:tl-coll-dists} +Płytka \DVD{} \TK{} zawiera: \begin{description} @@ -289,25 +270,18 @@ Płytka \TK{} \DVD{} zawiera: twardym dysku lub przygotowanie przenośnej instalacji np. na pendrivie, strona domowa projektu: \url{https://tug.org/texlive/}; -\item [Mac\TeX] dla systemu \MacOSX; posiada własny program instalacyjny +\item [Mac\TeX] dla systemu \macOS\ posiada własny program instalacyjny \macOS\ i~dodatkowe programy dla tego systemu, strona domowa projektu: \url{https://tug.org/mactex/}; +%%%%% +\item [\MIKTEX] Inna dystrybucja dla wszystkich systemów operacyjnych tj. Windows, GNU/Linux i~\macOS\ (ale DVD zawiera tylko binaria dla Windows). Posiada zintegrowany menedżer pakietów, który instaluje brakujące komponenty z Internetu, w zależności od potrzeb. +Strona domowa projektu: \url{https://miktex.org}; -\item [pro\TeX{}t] to, oparta na \MIKTEX-u dystrybucja dla Windows, -rozszerzona o~dodatkowe narzędzia; całkowicie niezależna od \TL. -\ProTeXt\ posiada własny, łatwy w~obsłudze program instalacyjny, - strona domowa projektu: \url{https://tug.org/protext}; - -\item [CTAN] to zrzut zawartości archiwów \CTAN{}; -(\url{https://www.ctan.org}). +\item [CTAN] to zrzut zawartości archiwów \CTAN{} (\url{https://www.ctan.org}). \CTAN\/ nie spełnia tych samych wymogów dotyczących swobody kopiowania co \TL{}, więc należy być +ostrożnym podczas redystrybucji lub modyfikacji. \end{description} -\CTAN i \pkgname{protext} nie spełniają przyjętych dla -\TL{} wymogów dotyczących swobody kopiowania, wobec tego należy ten fakt -uwzględnić przy redystrybucji bądź modyfikacji zawartości wymienionych -katalogów. - \subsection{Główne katalogi \protect\TL} \label{sec:tld} @@ -360,6 +334,7 @@ w~podkatalogach \dirname{texmf-dist/doc/texlive}: \item{polski:} \OnCD{texmf-dist/doc/texlive/texlive-pl} \item{rosyjski:} \OnCD{texmf-dist/doc/texlive/texlive-ru} \item{serbski:} \OnCD{texmf-dist/doc/texlive/texlive-sr} +\item{hiszpański:} \OnCD{texmf-dist/doc/texlive/texlive-es} \item{uproszczony chiński:} \OnCD{texmf-dist/doc/texlive/texlive-zh-cn} \end{itemize*} @@ -403,10 +378,10 @@ znaczy, drzewa umieszczone na liście później przesłaniają wcześniejsze. Zmienna ta wskazuje własny katalog każdego użytkownika. \item [TEXMFVAR] Lokalne drzewo katalogów wykorzystywane przez \verb+texconfig+, \verb+updmap-user+ i~\verb+fmtutil-use+ do przechowywania wygenerowanych plików - formatów i~map fontowych (domyślnie w~ramach \envname{TEXMFHOME}). + formatów i~map fontowych.% (domyślnie w~ramach \envname{TEXMFHOME}). \item [TEXMFCONFIG] Lokalne drzewo katalogów wykorzystywane przez narzędzia \verb+texconfig+, \verb+updmap-sys+ oraz \verb+fmtutil-sys+ do przechowywania - danych konfiguracyjnych (domyślnie w~ramach \envname{TEXMFHOME}). + danych konfiguracyjnych.% (domyślnie w~ramach \envname{TEXMFHOME}). \item [TEXMFCACHE] Drzewa katalogów wykorzystywane przez \ConTeXt\ MkIV oraz Lua\LaTeX\ do przechowywania buforowanych danych z~przetwarzania; domyślna wartość w~\TL{} jest identyczna @@ -417,20 +392,20 @@ znaczy, drzewa umieszczone na liście później przesłaniają wcześniejsze. \noindent Oto domyślny układ katalogów: \begin{description} - \item[ogólnosystemowy katalog instalacji] może zawierać kilka wydań \TL{}: + \item[ogólnosystemowy katalog instalacji] może zawierać kilka wydań \TL{} (\texttt{/usr/local/texlive} domyślnu dla Unix): \begin{ttdescription} - \item[2021] poprzednie wydanie - \item[2022] wydanie aktualne + \item[2022] poprzednie wydanie + \item[2023] wydanie aktualne \begin{ttdescription} - \item [bin] ~ + \item [bin] ~ \begin{ttdescription} - \item [i386-linux] \ \ \ \ \ programy dla \GNU/Linux (32-bit) + \item [i386-linux] \ \ \ \ \ binaria dla \GNU/Linux (32-bit) \item [...] - \item [universal-darwin] programy dla \MacOSX - \item [x86\_64-linux] programy dla \GNU/Linux (64-bit) - \item [win32] \ \ \quad \ \ \qquad programy dla Windows + \item [universal-darwin] binaria dla \macOS + \item [x86\_64-linux] binaria dla \GNU/Linux (64-bit) + \item [windows] \ \ \quad \ \ \qquad binaria dla Windows (64-bit) \end{ttdescription} - \item [texmf-dist\ \ ] określany zmienną \envname{TEXMFDIST} i \envname{TEXMFMAIN} + \item [texmf-dist\ \ ] określany zmienną \envname{TEXMFDIST} i~\envname{TEXMFMAIN} \item [texmf-var\ \ \ ] \envname{TEXMFSYSVAR}, \envname{TEXMFCACHE} \item [texmf-config] \envname{TEXMFSYSCONFIG} \end{ttdescription} @@ -440,9 +415,9 @@ Oto domyślny układ katalogów: \item[katalog domowy użytkownika] (\texttt{\$HOME} lub \texttt{\%USERPROFILE\%}) \begin{ttdescription} - \item[.texlive2021] prywatne pliki konfiguracyjne - poprzedniego wydania \item[.texlive2022] prywatne pliki konfiguracyjne + poprzedniego wydania + \item[.texlive2023] prywatne pliki konfiguracyjne bieżącego wydania \begin{ttdescription} \item [texmf-var\ \ \ ] \envname{TEXMFVAR}, \envname{TEXMFCACHE} @@ -485,7 +460,7 @@ Jego witryna internetowa znajduje się pod adresem \url{https://www.luatex.org/} a~podręcznik w~instalacji w~pliku \OnCD{texmf-dist/doc/luatex/base/luatex.pdf}. \item [(e)(u)p\TeX] obsługują japońskie wymagania składu; p\TeX{} jest -silnikiem podstawowym, wariant e- dodaje funkcjonalność \eTeX{}-a +silnikiem podstawowym, wariant e-~dodaje funkcjonalność \eTeX{}-a a~wariant u-~obsługę Unicode. \item [\XeTeX] przyjmuje teksty kodowane w~Unicode oraz może korzystać @@ -533,9 +508,9 @@ postscriptowych; \item [pdfjam, pdfjoin, \ldots]: narzędzia do manipulacji na plikach PDF; -\item [context, mtxrun]: programy uruchomieniowe dla Con\TeX{}t; +\item [context, mtxrun]: programy uruchomieniowe dla \ConTeXt\ i~PDF; -\item [htlatex, \ldots ] \cmdname{tex4ht}: postprocesor konwersji do HTML (i~XML, DocX i innych). +\item [htlatex, \ldots ] \cmdname{tex4ht}: \AllTeX{} postprocesor konwersji do HTML (i~XML, DocX i innych). \end{cmddescription} @@ -563,10 +538,10 @@ w~katalogu \dirname{install-tl} znajdziemy skrypty instalacyjne \filename{install-tl} i~\filename{install-tl-windows.bat}. \item [Instalacja z~sieci; Windows .exe:] -Z~archiwum \CTAN pobrać plik jak poprzednio i~ kliknąć dwa razy. Na ekranie pojawi się okienko widoczne na rys.~\ref{fig:nsis}, uruchomiony zostanie pierwszy krok instalacji i~będziemy mogli wybrać jedną z~dwóch akcji: ,,Install'' (zainstaluj) lub ,,Unpack only'' (tylko rozpakuj). +Z~archiwum \CTAN{} pobrać plik jak poprzednio i~ kliknąć dwa razy. Na ekranie pojawi się okienko widoczne na rys.~\ref{fig:nsis}, uruchomiony zostanie pierwszy krok instalacji i~będziemy mogli wybrać jedną z~dwóch akcji: 'Install' (zainstaluj) lub 'Unpack only' (tylko rozpakuj). -\item [Instalacja z płytki \TeX{} Collection \DVD:] Po uruchomieniu +\item [Instalacja\TeX{} Collection z płytki \DVD:] Po uruchomieniu płytki należy przejść do katalogu \dirname{texlive} \DVD{} (w~Windows program instalacyjny powinien uruchomić się automatycznie po włożeniu płytki). \DVD{} otrzymamy w ramach członkostwa w~dowolnej grupie użytkowników @@ -580,7 +555,7 @@ bezpośrednio z~internetu (patrz rozdział~\ref{sec:dvd-install-net-updates}). \begin{figure}[tb] \def\figdesc{First stage of Windows \code{.exe} installer} \tlpng{nsis_installer}{.6\linewidth}{\figdesc} -\caption{Po naciśnięciu guzika Instaluj pojawi się okienko jak na rysunku~\ref{fig:basic-w32}.}\label{fig:nsis} +\caption{\figdesc. Po naciśnięciu guzika Instaluj pojawi się okienko jak na rysunku~\ref{fig:basic-w32}.}\label{fig:nsis} \end{figure} Bez względu na źródło program instalacyjny jest ten sam. @@ -612,12 +587,8 @@ itd.; w~dalszej części nie będziemy powtarzali wszelkich możliwych kombinacj Zalecane jest powiększenie okna terminala, aby wyświetlić pełną zawartość ekranu programu instalacyjnego (rys.~\ref{fig:text-main}).%rysunek jest dalej -%to jest w tekście dalej - -%dotąd - -Do uruchomienia w~trybie graficznym (\GUI; rys.~\ref{fig:advanced-lnx}) %ten rysunek też jest dalej -wymagane jest zainstalowanie w~systemie Tcl/Tk. +Do uruchomienia w~trybie graficznym (\GUI; rys.~\ref{fig:advanced-lnx}) +wymagane jest zainstalowanie w~systemie programu Tcl/Tk. Mając go możemy uruchomić: \begin{alltt} > \Ucom{perl install-tl -gui} @@ -630,7 +601,6 @@ Kompletny wykaz dostępnych opcji można uzyskać uruchamiając: > \Ucom{perl install-tl -help} \end{alltt} - \textbf{O uprawnieniach w Unix:} program instalacyjny będzie respektować aktualną wartość \code{umask}. Jeżeli więc chcemy, aby instalacja była dostępna dla innych użytkowników, @@ -644,20 +614,20 @@ wymagane dla instalatora \TL. Dodatkowe informacje -- patrz część~\ref{sec:cygwin}. -\subsubsection{\MacOSX} +\subsubsection{\macOS} \label{sec:macosx} -Jak wspomniano w części \ref{sec:tl-coll-dists}, dla Mac\,OS\,X{} -przygotowano odrębną dystrybucję Mac\TeX\ (\url{https://tug.org/mactex}). +Jak wspomniano w części \ref{sec:tl-coll-dists}, dla \macOS +przygotowano odrębną dystrybucję nazwaną Mac\TeX\ (\url{https://tug.org/mactex}). W~jej wypadku należy użyć dedykowanego programu instalacyjnego, gdyż zmienia on w~specyficzny sposób ustawienia systemu, w~szczególności pozwala -na łatwe przełączanie między różnymi dystrybucjami \TL\ dla %Mac-ów \TeX-a -\MacOSX\ (Mac\TeX, Fink, MacPorts, \ldots), wykorzystując tzw. -struktury danych \TeX{}Dist. +na łatwe przełączanie między różnymi dystrybucjami \TL\ dla Macs, +%\MacOSX\ (Mac\TeX, Fink, MacPorts, \ldots), +wykorzystując tzw. struktury danych \TeX{}Dist. Mac\TeX\ jest oparty na \TL{} i główne drzewa katalogów, programy są -w~nim dokładnie takie same; dodano jedynie katalogi ze specyficznymi dla -systemu \MacOSX\ dokumentacjami i~aplikacjami. +w~nim dokładnie takie same; dodano jedynie katalogi ze specyficznymi dla tego +systemu dokumentacjami i~aplikacjami. @@ -666,9 +636,7 @@ systemu \MacOSX\ dokumentacjami i~aplikacjami. Gdy używamy pobranego z~sieci i~rozpakowanego z~pliku zip instalatora (bądź program ten nie uruchamia się automatycznie po włożeniu \DVD{} do napędu), należy uruchomić \filename{install-tl-windows.bat} (np. -podwójnym kliknięciem myszy). %Jeżeli potrzebujemy więcej opcji -%instalacyjnych (np. wyboru konkretnych kolekcji pakietów), możemy -%uruchomić alternatywny \filename{install-tl-advanced.bat}. +podwójnym kliknięciem myszy). Można to uczynić także z~linii poleceń. Poniżej \texttt{>} oznacza znak zachęty systemu (tzw. prompt); to, co wpisuje użytkownik, zaznaczono \Ucom{\texttt{pogrubieniem}}. @@ -697,13 +665,12 @@ Wszystkie dostępne opcje wyświetlimy uruchamiając: \end{alltt} \textbf{Note.} Jeśli ten sam katalog zawiera \texttt{install-tl-windows.exe} należy dodać przedłużenie \texttt{.bat} do uruchamianego \begin{alltt} -> \Ucom{install-tl-windows}\end{alltt}%extension if the same directory -%also contains \texttt{install-tl-windows.exe}. +> \Ucom{install-tl-windows}\end{alltt} (Tak się może zdarzyć jeśli lokalnie wykonano kopię lustrzaną katalogu \dirname{tlnet}). \begin{figure}[tb] \begin{boxedverbatim} -Installing TeX Live 2022 from: ... +Installing TeX Live 2023 from: ... Platform: x86_64-linux => 'GNU/Linux on x86_64' Distribution: inst (compressed) Directory for temporary files: /tmp @@ -715,11 +682,11 @@ Directory for temporary files: /tmp <S> set installation scheme: scheme-full <C> customizing installation collections - 40 collections out of 41, disk space required: 7239 MB + 40 collections out of 41, disk space required: 7620 MB (free: 138718 MB) <D> directories: TEXDIR (the main TeX directory): - /usr/local/texlive/2022 + /usr/local/texlive/2023 ... <O> options: @@ -739,12 +706,12 @@ Actions: \end{figure} \begin{figure}[tb] -\tlpng{basic-w32}{.6\linewidth}{Podstawowy ekran instalatora (Windows)} +\tlpng{basic-w32}{.6\linewidth}{Basic instaler screen (Windows)} \caption{Podstawowy ekran instalatora (Windows). Przycisk ,,Advanced'' (Zaawansowane) przywoła ekran podobny do rys. \ref{fig:advanced-lnx}}\label{fig:basic-w32} \end{figure} \begin{figure}[tb] -\tlpng{advanced-lnx}{\linewidth}{Zaawansowany ekran instalatora (Windows)} +\tlpng{advanced-lnx}{\linewidth}{Advanced installer screen (\GNU/Linux)} \caption{Zaawansowany ekran instalatora \GUI{} (\GNU/Linux)}\label{fig:advanced-lnx} \end{figure} @@ -808,22 +775,21 @@ opcji i~dostępnych podmenu. \begin{boxedverbatim} Available platforms: (dostępne platformy:) =============================================================================== - a [ ] Cygwin on Intel x86 (i386-cygwin) - b [ ] Cygwin on x86_64 (x86_64-cygwin) - c [ ] MacOSX current (10.14-) on ARM/x86_64 (universal-darwin) - d [ ] MacOSX legacy (10.6-) on x86_64 (x86_64-darwinlegacy) - e [ ] FreeBSD on x86_64 (amd64-freebsd) - f [ ] FreeBSD on Intel x86 (i386-freebsd) - g [ ] GNU/Linux on ARM64 (aarch64-linux) - h [ ] GNU/Linux on ARMv6/RPi (armhf-linux) - i [ ] GNU/Linux on Intel x86 (i386-linux) - j [X] GNU/Linux on x86_64 (x86_64-linux) - k [ ] GNU/Linux on x86_64 with musl (x86_64-linuxmusl) - l [ ] NetBSD on x86_64 (amd64-netbsd) - m [ ] NetBSD on Intel x86 (i386-netbsd) - o [ ] Solaris on Intel x86 (i386-solaris) - p [ ] Solaris on x86_64 (x86_64-solaris) - s [ ] Windows (win32) + a [ ] Cygwin on Intel x86_64 (x86_64-cygwin) + b [ ] MacOSX current (10.14-) on ARM/x86_64 (universal-darwin) + c [ ] MacOSX legacy (10.6-) on x86_64 (x86_64-darwinlegacy) + d [ ] FreeBSD on x86_64 (amd64-freebsd) + e [ ] FreeBSD on Intel x86 (i386-freebsd) + f [ ] GNU/Linux on ARM64 (aarch64-linux) + g [ ] GNU/Linux on RPi (32 bit) and ARMv7 (armhf-linux) + h [ ] GNU/Linux on Intel x86 (i386-linux) + i [X] GNU/Linux on x86_64 (x86_64-linux) + j [ ] GNU/Linux on x86_64 with musl (x86_64-linuxmusl) + k [ ] NetBSD on x86_64 (amd64-netbsd) + l [ ] NetBSD on Intel x86 (i386-netbsd) + m [ ] Solaris on Intel x86 (i386-solaris) + o [ ] Solaris on x86_64 (x86_64-solaris) + p [ ] Windows (64-bit) (windows) \end{boxedverbatim} \vskip-.5\baselineskip \caption{Dostępne platformy (systemy operacyjne)}\label{fig:bin-text} @@ -835,7 +801,6 @@ być to przydatne do instalacji drzewa \TeX-a na serwerze i~współdzielenia zas dla różnych systemów operacyjnych, albo instalacji dla kilku systemów na tej samej maszynie. -%%%%%%%%%%%%%%%%%%%%%%%%%% \subsubsection{Wybór składników do instalacji} \label{sec:components} @@ -848,11 +813,12 @@ b [ ] typowy (medium) -- skromny + więcej pakietów i języków c [ ] skromny (small) -- podstawowy + xetex, metapost, kilka języków d [ ] podstawowy (basic) -- plain i latex e [ ] minimalny -- tylko plain -f [ ] ConTeXt -g [ ] GUST -h [ ] wyłącznie schemat plików -- w ogóle bez TeX-a -i [ ] teTeX -- obszerniejszy niż typowy, ale mniejszy od pełnego -j [ ] wybór niestandardowy +f [ ] wyłącznie schemat plików -- w ogóle bez TeX-a +g [ ] składanie książek -- tylko LaTeX i dodatki +h [ ] ConTeXt +i [ ] GUST +j [ ] teTeX -- obszerniejszy niż typowy, ale mniejszy od pełnego +k [ ] wybór niestandardowy \end{boxedverbatim} \vskip-.5\baselineskip \caption{Schematy dostępne w instalacji}\label{fig:scheme-text} @@ -865,15 +831,15 @@ Na rysunku \ref{fig:scheme-text} oprócz wymienionych, znajdziemy również sche \begin{figure}[tb] -\begin{center} -\def\figdesc{Menu Collections (Kolekcje)} +%\begin{center} +\def\figdesc{Collections menu} \centering \tlpng{stdcoll}{.7\linewidth}{\figdesc} -\caption{Menu Collections (Kolekcje)}\label{fig:collections-gui} -\end{center} +\caption{\figdesc}\label{fig:collections-gui} +%\end{center} \end{figure} -Wybrany schemat można zmodyfikować korzystając z menu ,,Kolekcje''. -Rysunek~\ref{fig:collections-gui} pokazuje okno ,,Collections'' w trybie graficznym. +Wybrany schemat można zmodyfikować korzystając z menu pokazanego na +Rysunku~\ref{fig:collections-gui}. Kolekcje są o jeden poziom bardziej szczegółowe niż schematy -- w~skład schematu wchodzi wiele kolekcji, kolekcje składają się z jednego lub więcej pakietów, a pakiet @@ -889,7 +855,7 @@ na poziomie pakietów. Domyślny układ katalogów opisano w części~\ref{sec:texmftrees} na str.~\pageref{sec:texmftrees}. Położenie domyślne całej instalacji to -\dirname{/usr/local/texlive/2022} w~systemach Unix i~|%SystemDrive%\texlive\2022| w~Windows. +\dirname{/usr/local/texlive/2023} w~systemach Unix i~|C:\texlive\2023| w~Windows. Taka organizacja pozwala mieć kilka równoległych instalacji, każdą dla konkretnego roku wydania, i~łatwo się między nimi przełączać, zmieniając jedynie kolejność ścieżek przeszukiwania. @@ -902,7 +868,7 @@ Do zainstalowanie \TL\ nie jest konieczne posiadanie uprawnień administratora, musimy jednak mieć uprawnienia do zapisu w~docelowym katalogu. Graficzny ekran pokazujący tę i~inne opcje jest pokazany na rysunku~\ref{fig:advanced-lnx}. -Zwykle w Windows nie musimy być administratorem aby katalog |%SystemDrive%\texlive\2022| został utworzony. +Zwykle w Windows nie musimy być administratorem aby katalog |%SystemDrive%\texlive\2023| został utworzony. Katalogi instalacyjne można również zmienić ustawiając różne zmienne środowiskowe przed uruchomieniem instalatora (najczęściej są to @@ -914,7 +880,7 @@ wyświetlanej poleceniem |install-tl --help| (dostępnej też online na stronie Rozsądną alternatywą może być wtedy instalacja w~katalogu domowym, szczególnie gdy będziemy jej jedynym użytkownikiem. Dla zaznaczenia katalogu domowego użytkownika stosujemy zapis ,,|~|'', np. -|~/texlive/2022|. Zalecamy użycie katalogu z~nazwą odzwierciedlającą +'|~/texlive/2023|'. Zalecamy użycie katalogu z~nazwą odzwierciedlającą rok wydania, co pozwoli na zainstalowanie obok siebie różnych wydań \TL{}. Zmiana \dirname{TEXDIR} w programie instalacyjnym zmieni także ścieżki @@ -976,13 +942,6 @@ rysunku~\ref{fig:options-text} podajemy poniżej. \item[create all format files:] (generuj pliki formatów) Zaleca się pozostawić tę opcję włączoną aby uniknąć niepotrzebnych problemów przy dynamicznym tworzeniu formatów. Więcej informacji można znaleźć w dokumentacji \prog{fmtutil}. - -% chociaż zbędne formaty zajmują miejsce na dysku; -% jeżeli tego nie zrobimy, formaty będą generowane automatycznie (w~razie potrzeby) -% w~prywatnych katalogach \dirname{TEXMFVAR} użytkowników, jednak gdy w~instalacji -% zostaną zaktualizowane np. same programy bądź wzorce przenoszenia, te w~katalogach -% prywatnych odświeżone nie będą; wskutek tego pliki formatów mogą utracić zgodność -% ze środowiskiem, w~którym są używane. \item[install font/macro \ldots\ tree:] Ładuje/instaluje dokumentacje i źródła zawarte w~większości pakietów. Wyłączenie tej opcji nie jest zalecane. @@ -1050,7 +1009,7 @@ nazwę poprzedzić znakiem |-| lub |--|. Oto najczęściej używane: \begin{ttdescription} \item[-gui] Użyj (jeśli to możliwe) programu w~wersji graficznej (\GUI). Wersja graficzna wymaga - modułu Tcl/Tk w~wersji 8.5 lub wyższej. Obecnie w przypadku Mac\,OS\,X trzeba zainstalować Tcl/Tk samodzielnie, jeśli nie chce się korzystać z instalatora Mac\TeX-a, dla Windows jest + modułu Tcl/Tk w~wersji 8.5 lub wyższej. W przypadku \macOS był on dystrybuowany ze starszymi wersjami, dla Big Sur i późniejszych trzeba zainstalować Tcl/Tk samodzielnie, jeśli nie chce się korzystać z instalatora Mac\TeX-a. Tcl/Tk dla Windows jest dystrybuowany z \TL. Starsze opcje \texttt{-gui=perltk} i~\texttt{-gui=wizard} są nadal dostępne, ale uruchomiają ten sam interfejs \GUI{}. Jeśli Perl/Tk i~Tcl/Tk są niedostępne, program instalacyjny uruchomiony zostanie w~trybie tekstowym. @@ -1113,7 +1072,7 @@ prawdziwą nazwę hosta i jego konkretną ścieżkę do korzenia \CTAN, zamiast stronie \url{https://ctan.org/mirrors}. Jeśli podany argument wskazuje na lokalny dysk (ścieżkę bądź adres \texttt{file:/}), wybrana -zostanie instalacja ze skompresowanych plików zawartych %\filename{tar.xz}, +zostanie instalacja ze skompresowanych plików zawartych w~podkatalogu \dirname{archive} (nawet jeśli są dostępne pliki nieskompresowane). \htmlanchor{postinstall} @@ -1129,7 +1088,7 @@ Użycie opisanej w~części~\ref{sec:options} opcji tworzenia dowiązań symbolicznych w~standardowych katalogach nie wymaga zmian w zmiennych środowiska systemowego. Niemniej jednak w systemach Unix po instalacji należy do zmiennej \envname{PATH} dodać ścieżkę do -programów \TL. (W Windows program instalacyjny czyni to za nas). +programów \TL. (W Windows program instalacyjny czyni to za nas.) Każda z~obsługiwanych platform ma własny podkatalog w~ramach \dirname{TEXDIR/bin}. Listę platform i~odpowiadających im katalogów @@ -1139,22 +1098,22 @@ Również korzystanie z~systemowych przeglądarek dokumentacji \prog{man} i~\prog{info} staje się możliwe dopiero po dodaniu odpowiednich katalogów do ich ścieżek przeszukiwania. Strony \prog{man} mogą być także znajdywane automatycznie po dodaniu -ścieżki ich położenia do \envname{MANPATH}. +ścieżki ich położenia do \envname{PATH}. Dla powłoki zgodnej z~Bourne takiej jak \prog{bash}, używając na przykład Intel x86 \GNU/Linux i~domyślnej konfiguracji \TL , należałoby edytować plik \filename{$HOME/.profile} (lub inny pochodzący z \filename{.profile}) i~dopisać linie: \begin{sverbatim} -PATH=/usr/local/texlive/2022/bin/x86_64-linux:$PATH; export PATH -MANPATH=/usr/local/texlive/2022/texmf-dist/doc/man:$MANPATH; export MANPATH -INFOPATH=/usr/local/texlive/2022/texmf-dist/doc/info:$INFOPATH; export INFOPATH +PATH=/usr/local/texlive/2023/bin/x86_64-linux:$PATH; export PATH +MANPATH=/usr/local/texlive/2023texmf-dist/doc/man:$MANPATH; export MANPATH +INFOPATH=/usr/local/texlive/2023/texmf-dist/doc/info:$INFOPATH; export INFOPATH \end{sverbatim} W~wypadku csh lub tcsh należy zmodyfikować plik \filename{$HOME/.cshrc} i dopisać linie: \begin{sverbatim} -setenv PATH /usr/local/texlive/2022/bin/x86_64-linux:$PATH -setenv MANPATH /usr/local/texlive/2022/texmf-dist/doc/man:$MANPATH -setenv INFOPATH /usr/local/texlive/2022/texmf-dist/doc/info:$INFOPATH +setenv PATH /usr/local/texlive/2023/bin/x86_64-linux:$PATH +setenv MANPATH /usr/local/texlive/2023/texmf-dist/doc/man:$MANPATH +setenv INFOPATH /usr/local/texlive/2023/texmf-dist/doc/info:$INFOPATH \end{sverbatim} Jeśli nie używasz systemu \code{x86\_64-linux}, użyj odpowiedniej nazwy; podobnie jeśli instalacja nie została przeprowadzona w domyślnym katalogu, @@ -1174,18 +1133,20 @@ konfigurowania w~różnych systemach aby je wszystkie tutaj opisywać. Nasze dwie rady są następujące: 1)~można sprawdzić plik \filename{/etc/manpath.config} i,~jeśli istnieje, dodać w~nim wiersze \begin{sverbatim} -MANPATH_MAP /usr/local/texlive/2021/bin/x86_64-linux \ - /usr/local/texlive/2021/texmf-dist/doc/man +MANPATH_MAP /usr/local/texlive/2023/bin/x86_64-linux \ + /usr/local/texlive/2023/texmf-dist/doc/man \end{sverbatim} + 2)~można sprawdzić plik \filename{/etc/environment}, w~którym może być zdefiniowana ścieżka wyszukiwania i~inne domyślne zmienne środowiska. -W każdym katalogu w~plikami wykonywalnymi systemów uniksowych możemy też utworzyć +W każdym (Unix-owym) katalogu w~plikami wykonywalnymi systemów uniksowych możemy też utworzyć symboliczne dowiązanie o~nazwie \code{man} do katalogu \dirname{texmf-dist/doc/man}. Niektóre programy \code{man}, np. standardowy -program \code{man} w~systemie Mac\,OS\,X automatycznie znajdą to dowiązanie, +program \code{man} w~systemie \macOS automatycznie znajdą to dowiązanie, likwidując potrzebę jakiegokolwiek działania z~naszej strony. +%%% numer linii 1097 \subsubsection{Aktualizacje z internetu po instalacji z \DVD} \label{sec:dvd-install-net-updates} @@ -1211,60 +1172,66 @@ wraz z~pełną ścieżką do podkatalogu \dirname{tlnet}. \XeTeX\ i~Lua\TeX\ mogą używać wszystkich fontów zainstalowanych w~systemie, nie tylko tych znajdujących się w~katalogach \TeX-owych. Oba programy korzystają tu ze zbliżonych, ale jednak różnych metod. +Taki font systemowy (nie będący częścią \TL) jest dostępny zazwyczaj poprzez podanie nazwy czcionki, np. `\code{Liberation Serif}' choć można też użyć nazwy pliku systemowego. -W systemach Windows fonty dostarczone z~\TL\ są automatycznie dostępne -dla programu \XeTeX{} poprzez odwołanie do nazwy fontu. W~Mac\,OS\,X{} -wyszukanie fontów wymaga dodatkowych kroków; patrz strona Mac\TeX\ w~sieci -(\url{https://tug.org/mactex}). Dla innych systemów uniksowych należy -skonfigurować system tak, aby dowolny program mógł znaleźć fonty -dostarczone w~\TL. Aby to ułatwić, podczas instalacji pakietu -\pkgname{xetex} tworzony jest plik konfiguracyjny fontów: -\filename{TEXMFSYSVAR/fonts/conf/texlive-fontconfig.conf}. - -Aby udostępnić fonty \TL{} dla innych aplikacji systemu -(zakładając, że mamy odpowiednie uprawnienia) należy wykonać -następujące czynności: -\begin{enumerate*} -\item skopiować \filename{texlive-fontconfig.conf} do -\dirname{/etc/fonts/conf.d/09-texlive.conf}; -\item uruchomić \Ucom{fc-cache -fsv}. +Inną kwestią jest udostępnienie fontów z dystrybucji \TL\ w taki sposób, aby były dostępne po nazwie czcionki. + +Dla Lua\TeX: aby uzyskać dostęp do fontów z dystrybucji \TL\ nie trzeba robić nic szczególnego. Wszystkie fonty powinny być dostępne zarówno poprzez nazwę czcionki jak i fontu dzięki pakietowi \pkgname{luaotfload}, który obsługuje zarówno \LaTeX \ jak i ~TeX. Indeks nazw fontów pakietu \pkgname{luaotfload} może wymagać odświeżenia, ale dzieje się to automatycznie w momencie próby załadowania nieznanego dotychczas fontu. + + Dla \XeTeX: dla Windows, fonty z \TL\/ są dostępne automatycznie (poprzez uruchomienie programu \cmdname{fc-cache} dostarczonego jako część \TL). + Dla Mac, należy zapoznać się z inną dokumentacją. Dla systemów Unix, inaczej niż dla \macOS, procedura jest następująca. + + Kiedy zostanie zainstalowany pakiet \pkgname{xetex} (albo w czasie pierwszej instalacji albo później), potrzebny plik konfiguracyjny jest tworzony w~\filename{TEXMFSYSVAR/fonts/conf/texlive-fontconfig.conf}. Aby sprawić, że fonty \TL\ są dostępne jako fonty systemowe należy: + \begin{enumerate*} +\item Skopiować plik \filename{texlive-fontconfig.conf} do (zazwyczaj) +\dirname{/etc/fonts/conf.d/09-texlive.conf}. +\item Uruchomić \Ucom{fc-cache -fsv}. \end{enumerate*} -Jeśli nie mamy odpowiednich uprawnień aby wykonać kroki przedstawione powyżej -lub chcemy fonty \TL{} udostępnić tylko jednemu użytkownikowi, możemy: +Jeżeli nie masz wystarczających uprawnień do wykonania powyższych kroków lub gdy chcesz udostępnić fonty z \TL{} tylko jednemu użytkownikowi, możesz postąpić następująco: \begin{enumerate*} -\item skopiować plik \filename{texlive-fontconfig.conf} do - \filename{~/.fonts.conf}, gdzie \filename{~} oznacza nasz katalog domowy. -\item uruchomić \Ucom{fc-cache -fv}. +\item Skopiować plik \filename{texlive-fontconfig.conf} do (zazwyczaj) + \filename{~/.fonts.conf.d/09-texlive.conf}, gdzie \filename{~} jest twoim katalogiem domowym. +\item Uruchomić \Ucom{fc-cache -fv}. \end{enumerate*} + +%%%%%wiersz 1160 Aby wyświetlić nazwy fontów systemowych trzeba uruchomić program \code{fc-list}. Uruchomienie go z~dodatkową opcją \code{fc-list : family style file spacing} wyświetli więcej interesujących informacji. +%You can run \code{fc-list} to see the names of the available system +%fonts. The incantation \code{fc-list : family style file spacing} (all +%those arguments are literal strings) shows some generally interesting +%information. -\subsubsection{\protect\ConTeXt{} Mark IV} + +\subsubsection{\protect\ConTeXt{} LMTX i MKIV} \label{sec:context-mkiv} -Po zainstalowaniu \TL, zarówno tzw. ,,stary'' \ConTeXt{} (Mark II), jak i~nowy -\ConTeXt{} (Mark IV) powinny działać bez problemów, o~ile do aktualizacji będziemy +Po zainstalowaniu \TL zarówno 'stary' \ConTeXt{} (Mark IV or MkIV) jak i~`nowy' \ConTeXt{} (LMTX) powinny działać bez problemów, o~ile do aktualizacji będziemy używać wyłącznie programu \verb+tlmgr+. -Ponieważ \ConTeXt{} MkIV nie stosuje biblioteki kpathsea do -wyszukiwania plików, po zainstalowaniu ręcznie nowych plików (bez użycia -\verb+tlmgr+) każdy użytkownik MkIV musi uruchomić: +Jednakże, ponieważ \ConTeXt{} nie używa biblioteki kpathsea, gdy będziemy instalować nowe pliki ręcznie (bez użycia verb+tlmgr+) +będzie wymagana pewna dodatkowa konfiguracja. Po każdej takiej +instalacji należy uruchomić: \begin{sverbatim} context --generate \end{sverbatim} -aby odświeżyć dane buforowe \ConTeXt. +dla LMTX, i +\begin{sverbatim} +context --luatex --generate +\end{sverbatim} +dla MkIV, aby odświeżyć dane w pamięci podręcznej dysku. Wygenerowane pliki zostaną zapisane w~katalogach wskazywanych przez -zmienną \code{TEXMFCACHE} (domyślną wartością tej zmiennej w~\TL\ jest +zmienną \code{TEXMFCACHE}, której domyślną wartością w~\TL\ jest \verb+TEXMFSYSVAR;TEXMFVAR+). -\ConTeXt\ MkIV przeszuka wszystkie ścieżki wymienione w~\verb+TEXMFCACHE+ +\ConTeXt\ przeszuka wszystkie ścieżki wymienione w~\verb+TEXMFCACHE+ i~zapisze dane w~pierwszej ścieżce, która jest dostępna do zapisu. Gdy dane buforowe są zduplikowane, podczas ich odczytywania -zostaną wykorzystane ostatnio znalezione. +zostaną wykorzystane te ostatnio znalezione. Więcej informacji znajdziemy na stronach: \url{https://wiki.contextgarden.net/Running_Mark_IV}. @@ -1274,7 +1241,8 @@ Więcej informacji znajdziemy na stronach: Jak już wspomniano w~części~\ref{sec:texmftrees}, katalog \dirname{TEXMFLOCAL} (domyślnie \dirname{/usr/local/texlive/texmf-local} lub -\verb|%SystemDrive%\texlive\texmf-local| w~Windows) przeznaczony jest na lokalne +\verb|%SystemDrive%\texlive\texmf-local| w~Windows) +przeznaczony jest na lokalne (np. w~danej sieci komputerowej) fonty oraz pakiety makr. Z~kolei \dirname{TEXMFHOME} (domyślnie \dirname{$HOME/texmf} lub \verb|%USERPROFILE%\texmf|) jest przeznaczony na prywatne makra i~fonty @@ -1288,11 +1256,11 @@ podkatalogach, zgodnie z~zaleceniami \TDS{} (patrz: \url{https://tug.org/tds}, także plik \filename{texmf-dist/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). +(lub w ich podkatalogach). \dirname{TEXMFLOCAL} po zmianie zawartości wymaga odświeżenia bazy danych -- poleceniem \cmdname{mktexlsr} lub poprzez użycie przycisku ,,Odśwież bazy -danych'' w~graficznym trybie programu \TeX\ Live Manager (\prog{tlmgr}). +danych'' w~graficznym trybie programu \TL\ Manager \GUI (\prog{tlmgr}). Każda z tych zmiennych ma domyślnie przypisany pojedynczy katalog, ale nie musi być to regułą. Jeśli testujemy różne wersje pakietów, możemy @@ -1307,19 +1275,20 @@ dla listy katalogów, które oddzielamy przecinkami i~umieszczamy w~klamrach: W części \ref{sec:brace-expansion} opisano dokładniej analizę listy katalogów umieszczonych w klamrach. + \subsubsection{Integracja fontów z innych źródeł} Dla \TeX-a i~pdf\TeX-a jest to, niestety, skomplikowane zagadnienie. Sugerujemy aby się tym nie zajmować, jeśli nie chce się zagłębiać w~szczegóły instalowania \TeX-a. -Wiele fontów jest już zawartych w~\TL, więc można się rozejrzeć; strony pod adresem +Wiele fontów jest już zawartych w~\TL, więc można wybrać taki jak nam odpowiada; strony pod adresem \url{https://tug.org/FontCatalogue} przedstawiają skategoryzowane na różne sposoby prawie wszystkie fonty tekstowe zawarte w~głównych dystrybucjach \TeX-a. -Procedury instalowania i integrowania fontów opisano na stronie: +Procedury instalowania i integrowania swoich osobistych fontów opisano na stronie: \url{https://tug.org/fonts/fontinstall.html}. Warto rozważyć użycie \XeTeX-a lub Lua\TeX-a, (patrz punkt \ref{sec:tex-extensions}), -które pozwalają na użycie fiontów zainstalowanych w sysytemie operacyjnym z~pominięciem +które pozwalają na użycie fontów zainstalowanych w sysytemie operacyjnym z~pominięciem jakiegokolwiek instalowania \TeX-owego. (Trzeba jednak zachować rozwagę, ponieważ użycie fontów systemowych czyni dokumenty nieużywalnymi w~innych środowiskach). @@ -1337,7 +1306,8 @@ systemach możemy korzystać z~dowolnego edytora, operującego na czystym tekście. Opiszemy tu podstawowe procedury testujące funkcjonowanie instalacji -w~systemach Unix, ale zasady dla Mac\,OS\,X{} i~Windows są identyczne. +w~systemach Unix, ale zasady dla \macOS{} i~Windows są identyczne. + \begin{enumerate} \item Sprawdzamy najpierw, czy uruchamia się program \cmdname{tex}: @@ -1366,20 +1336,18 @@ zmiennych środowiska bądź pliki konfiguracyjne z~innej (poprzedniej) instalac Szczegółową analizę, gdzie pliki są szukane i~znajdowane, umożliwia diagnostyka opisana w~części \ref{sec:debugging} na str.~\pageref{sec:debugging}. - +%%%% \item Podgląd wyniku składu (pliku PDF): \begin{alltt} > \Ucom{xpdf sample2e.dvi} # Unix \end{alltt} - W nowym oknie powinien pojawić się dokument wyjaśniający podstawy \LaTeX-a. -(Warto go przeczytać będąc początkującym użytkownikiem.) +(Warto go przeczytać będąc początkującym użytkownikiem \TeX-a.) Oczywiście istnieje wiele przeglądarek PDF; w systemach Unix używa się \cmdname{evince} i~\cmdname{okular}. Dla Windows sugerujemy wypróbowanie Sumatra PDF (\url{https://www.sumatrapdfreader.org/free-pdf-reader.html}). -Przeglądarki PDF nie jest są dostarczane z \TL{}, należy więc osobno zainstalować przeglądarkę -swojego wyboru. +Przeglądarki PDF nie jest są dostarczane z \TL{}, należy więc wybraną przeglądarkę zainstalować osobno. \item Oczywiście można też nadal wygenerować dokument w oryginalnym \TeX-owym formacie \dvi{}: \begin{alltt} @@ -1402,8 +1370,8 @@ dokumentu pojawi się informacja \samp{Can't open display}. > \Ucom{dvips sample2e.dvi -o sample2e.ps} \end{alltt} -\item lub utworzenie dokumentu w~formacie PDF z~\dvi{}; to alternatywa -do użycia pdf\TeX\-a (lub Xe\TeX\-a lub Lua\TeX-a), co niekiedy może użytecznym: +\item Tworzenie dokumentu w~formacie PDF z~\dvi{}; to alternatywa +do użycia pdf\TeX\-a (lub Xe\TeX\-a lub Lua\TeX-a), co niekiedy może użyteczne: \begin{alltt} > \Ucom{dvipdfmx sample2e.dvi -o sample2e.pdf} @@ -1431,6 +1399,7 @@ This is XeTeX, Version 3.14\dots Output written on opentype-info.pdf (1 page). Transcript written on opentype-info.log. \end{alltt} + Gdy otrzymamy komunikat błędu: ,,Invalid fontname `Latin Modern Roman/ICU'\dots'', oznacza to, że należy zmienić konfigurację systemu, jak to opisano @@ -1441,33 +1410,33 @@ w~punkcie~\ref{sec:font-conf-sys}. \subsection{Usuwanie instalacji \TL} \label{sec:uninstall} -Aby usunąć prawidłowo zainstalowany \TL\ należy uruchomić: +Aby usunąć prawidłowo zainstalowany \TL\ (dla Windows patrz poniżej) należy uruchomić: \begin{alltt} > \Ucom{tlmgr uninstall --all} \end{alltt} -Jeśli nie potwierdzisz chęci usunięcia instalacji, żadna akcja nie zostanie wykonana. +Jeśli nie potwierdzimy chęci usunięcia instalacji, żadna akcja nie zostanie wykonana. (Bez dodatku \code{-{}-all}, \code{uninstall} jest używany do usuwania pojedynczych pakietów.) -Nie zostaną też usunięte żadne katalogi własne użytkownika (patrz też część~\ref{sec:texmftrees}: +Przy usuwaniu całej instalacji żadne katalogi własne użytkownika nie zostaną usunięte (patrz też część~\ref{sec:texmftrees}: \begin{ttdescription} \item [TEXMFCONFIG] Zawiera informacje użytkownika o zmianach w konfiguracji. Jeśli chcesz je zachować, upewnij się przed usunięciem, że wiesz, jak je odtworzyć. \item [TEXMFVAR] Jest przeznaczony do przechowywania automatycznie generowanych -danych runtime, takich jak pliki lokalnych formatów. Jeśli nie używasz go do + runtime data, takich jak pliki lokalnych formatów. Jeśli nie używasz go do innych celów, można go bezpiecznie usunąć. \item[TEXMFHOME] Zawiera tylko pliki które użytkownik zainstalował samodzielnie i które nie wchodzą w skład dystrybucji. Jeśli chcesz przeprowadzić instalację \TeX\ od początku warto tego nie usuwać. \end{ttdescription} -\noindent Możesz znaleźć ścieżkę dostępu do tych katalogów uruchamiając +\noindent Możesz znaleźć ścieżkę dostępu do opisanych katalogów uruchamiając \code{kpsewhich -var-value=\ttvar{var}}. - \prog{tlmgr} usuwa instalację ale nie usuwa zmian wykonanych w~procesie poinstalacyjnym w~\envname{PATH} oraz dostępu systemu do fontów \TL\ (patrz część~\ref{sec:postinstall}). - Należy je usunąć ręcznie w~razie potrzeby. +Należy pamiętać, że \prog{tlmgr} usuwa instalację ale nie usuwa zmian wykonanych w~procesie poinstalacyjnym w~\envname{PATH} oraz dostępu do fontów \TL\ (patrz część~\ref{sec:postinstall}). + Należy je, w~razie potrzeby, usunąć ręcznie. Dla Windows, usuwanie instalacji może być wykonane poprzez \GUI; patrz część~\ref{sec:winfeatures}. @@ -1492,7 +1461,7 @@ Poniżej znajdziesz linki do innych narzędzi, które mogą przydać się w pra \item \cmdname{Texmaker} darmowy, dostępny z \url{https://www.xm1math.net/texmaker}. \item \cmdname{TeXstudio} Oparty na \cmdname{Texmaker}, do którego dodano nowe właściwości; - dostępny z~\url{https://texstudio.org/} lub w~dystrybucji pro\TeX{}. + dostępny z~\url{https://texstudio.org/}.% lub w~dystrybucji pro\TeX{}. \item \cmdname{TeXnicCenter} darmowy, dostępny z~\url{https://www.texniccenter.org}. \item \cmdname{TeXworks} darmowy, dostępny z~\url{https://tug.org/texworks} i~instalowany jako część \TL\ (tylko dla Windows). @@ -1574,7 +1543,7 @@ konfiguracje indywidualne użytkowników i~pamięci podręczne (\textit{cache}). Do uruchomienia programów \TL\ w~takiej instalacji wystarczy w sesji terminala dodać, jak zazwyczaj, odpowiedni katalog do zmiennej \code{PATH}. -\newpage % wymuszam, aby poniższy tekst i ,,tray-menu'' były na tej samej stronie +%\newpage % wymuszam, aby poniższy tekst i ,,tray-menu'' były na tej samej stronie W~Windows należy dwukrotnie kliknąć \filename{tl-tray-menu} w głównym katalogu instalacji i~utworzyć pomocnicze `tray menu', które oferuje wybór spośród kilku podstawowych @@ -1587,13 +1556,13 @@ zadań, poniżej: dostosować menu do własnych potrzeb. \htmlanchor{tlmgr} -\section{\cmdname{tlmgr}: zarządzanie instalacją} +\section{\cmdname{tlmgr}: Zarządzanie instalacją} \label{sec:tlmgr} %%%% -\begin{figure}[tb] -\def\figdesc{\prog{tlshell} w trybie graficznym, menu Actions (Mac\,OS\,X{})} -\tlpng{tlshell-macos}{\linewidth}{\figdesc} +\begin{figure}[htb] +\def\figdesc{\prog{tlshell} w trybie graficznym (\GUI), menu Actions (\GNU/Linux)} +\tlpng{tlshell-linux}{\linewidth}{\figdesc} \caption{\figdesc} \label{fig:tlshell} \end{figure} @@ -1633,9 +1602,10 @@ użytkownikow przyzwyczajonym do tego interfejsu, zalecamy używanie \prog{tlmgr \subsection{\cmdname{tlmgr} -- tryb graficzny (\GUI)} -\TL{} dostarcza kilka trybów graficznych (\GUI) dla programu \cmdname{tlmgr}. -Rysunek~\ref{fig:tlshell} pokazuje \cmdname{tlshell} który jest napisany -w~Tcl/Tk i~działa pod Windows i~\MacOSX{}. Rysunek~\ref{fig:tlcockpit} +\TL{} dostarcza kilka trybów graficznych (\GUI) dla programu \cmdname{tlmgr}. Dwa najważniejsze to: +(1)~Rysunek~\ref{fig:tlshell} pokazuje \cmdname{tlshell} który jest napisany +w~Tcl/Tk i~działa pod Windows. +2)~Rysunek~\ref{fig:tlcockpit} pokazuje \prog{tlcockpit}, który wymaga programu Java w wersji~8 lub wyższej wraz z~JavaFX. Oba programy są dołączone w~osobnych pakietach. @@ -1680,12 +1650,12 @@ running post install action for xetex install: xetex-def ... running mktexlsr -mktexlsr: Updating /usr/local/texlive/2022/texmf-dist/ls-R... +mktexlsr: Updating /usr/local/texlive/2023/texmf-dist/ls-R... ... running fmtutil-sys --missing ... Transcript written on xelatex.log. -fmtutil: /usr/local/texlive/2022/texmf-var/web2c/xetex/xelatex.fmt installed. +fmtutil: /usr/local/texlive/2023/texmf-var/web2c/xetex/xelatex.fmt installed. \end{fverbatim} Jak widać, \prog{tlmgr} instaluje wszystkie pakiety zależne, a także @@ -1760,7 +1730,7 @@ opisanego w~punkcie~\ref{sec:sharedinstall}. %Istnieje też inne podejście, używając programu \filename{tlaunch}, %opisanego w~punkcie~\ref{sec:sharedinstall}. -\subsection{Programy pomocnicze dla Windows} +\subsection{Dodatkowe programy pomocnicze dla Windows} Początkującym użytkownikom polecamy stronę \url{https://tug.org/begin.html} oraz podręcznik @@ -1784,10 +1754,10 @@ programów, które nie są dostarczane z~systemem Windows. Instalowane są następujące programy: \begin{description} \item[Perl, Tcl/Tk i Ghostscript.] Ponieważ Perl i Ghostscript są niezbędne do -poprawnego działania \TL{}, i~ponieważ installer- i tlshell \GUI{} są napisane w~Td/Tk, \TL{} zawiera 'ukryte' kopie tych programów. Oczywiście programy \TL{}, które -z~nich korzystają, ,,wiedzą'' gdzie je znaleźć. To nie są pełne instalacje tym samym nie powinny +poprawnego działania \TL{}, i~ponieważ installer- i tlshell \GUI{} są napisane +w~Tcl/Tk, \TL{} zawiera 'ukryte' kopie tych programów. Oczywiście programy \TL{}, które z~nich korzystają, ,,wiedzą'' gdzie je znaleźć. To nie są pełne instalacje tym samym nie powinny kolidować z~ewentualnie zainstalowanymi w~systemie programami Perl -i~Ghostscript czy Td/Tk. +i~Ghostscript czy Tcl/Tk. Instrukcję jak poinformować \TL{} że chcemy używać naszych zewnętrznych instalacji do współpracy z \TL{} znajdziemy w~\ref{sec:externalwndws}. %Obydwa te programy są niezbędne do %poprawnego działania \TL{}, dołączyliśmy zatem \cmdname{Ghostscript} %i~minimalną dystrybucję \cmdname{Perl}, wystarczającą do @@ -1813,18 +1783,57 @@ generowania fontów staną się rzadsze. Więcej informacji można znaleźć w~bardzo dobrym poradniku \emph{on-line} tego programu. \item[\TeX{}works.] Zorientowany na środowisko \TeX-owe edytor, zintegrowany z~modułem do podglądu plików PDF. -\item[narzędzia uruchamiane z~linii poleceń] Do \TL{} są włączone - wersje Windowsowe +\item[narzędzia uruchamiane z~linii poleceń.] Do \TL{} są włączone + wersje Windows kilku przydatnych programów uniksowych. Są to programy: \cmdname{gzip}, \cmdname{zip}, \texttt{unzip} i~kilka narzędzi z~zestawu \cmdname{poppler} (\cmdname{pdfinfo}, \cmdname{pdffonts}, \ldots). %Nie ma oddzielnej przeglądarki plików PDF dla Windows. % Można pobrać z~internetu na przykład przeglądarkę PDF Sumatra: % \url{https://sumatrapdfreader.org/}. -\item[fc-list, fc-cache, \ldots] narzędzia z~biblioteki fontconfig; program -\prog{fc-cache} rejestruje dla \XeTeX-a fonty systemowe (Windows) lub dostarczane - w~dystrybucji \TL{} fonty OpenType; \prog{fc-list} wyświetla zarejestrowane + +\item[fc-list, fc-cache, \ldots] To narzędzia z~biblioteki \pkgname{fontconfig}. +\prog{fc-cache} rejestruje dla \XeTeX-a fonty systemowe (Windows).% lub dostarczane w~dystrybucji \TL{} fonty OpenType; +\prog{fc-list} wyświetla zarejestrowane fonty, podając ich pełne nazwy (deklarujemy je jako parametr rozszerzonego - w~\XeTeX-u polecenia \cs{font}). Jeżeli to konieczne, można uruchomić program \prog{fc-cache} aby otrzymać pełną informację o dostępnych fontach. + w~\XeTeX-u polecenia \cs{font}). Jeżeli to konieczne, należy uruchomić program \prog{fc-cache} aby odświerzyć informację o dostępnych fontach. \end{description} +\subsection{Korzystanie z zewnętrznych instalacji Perla, Tcl/Tk i Ghostscripta} +\label{sec:externalwndws} + + +Normalnie, \TL{} będzie używać wbudowanych Perla, Tcl/Tk i Ghostscripta, również +w przypadku skryptów dodanych w ramach \TL. Jeśli chcesz używać własnych, zewnętrznych +można to skonfigurować w pliku \file{texmf.cnf}. + +Dla Perla należy dodać linię +\begin{verbatim} +TEXLIVE_WINDOWS_TRY_EXTERNAL_PERL = 1 +\end{verbatim} +\TL{} (dokładnie, \file{bin/windows/runscript.tlu}) będzie wtedy poszukiwał + pliku \file{perl.exe} pomijając te skrypty (Perla), które należą do + infrastruktury \TL{}. Jest to najbardziej użyteczne przeszukanie; mimo, że \TL{} Perl zawiera wiele dodatkowych modułów, nie może obsługiwać wszystkich skryptów innych firm. + +Podobnie, dla Tcl/Tk należy dodać linię +\begin{verbatim} +TEXLIVE_WINDOWS_TRY_EXTERNAL_TCL = 1 +\end{verbatim} +\TL{} będzie wtedy poszukiwał + plików \file{tclkit.exe}, \file{wish.exe}, +\file{wish85.exe}, \file{wish86.exe} i~\file{wish87.exe}. + +Ghostscript is handled differently, in that you need to specify the +filename or the full path of your command-line Ghostscript: +Ghostscript jest obsługiwany inaczej, należy podać z linii poleceń +nazwę pliku lub pełną ścieżkę do zainstalowanego zewnętrznie Ghostscripta: +\begin{alltt} +TEXLIVE_WINDOWS_EXTERNAL_GS = \var{path of command-line ghostscript} +\end{alltt} +Kolejna różnica jest taka, że Ghostscript dostarczany z systemem +jest kompletny, pominięto jedynie dokumentację i sterowniki drukarki, więc +jest mało prawdopodobne, że będziesz potrzebował instalować go poza \TL. + + +Zobacz także rozdział \ref{sec:configfiles} dotyczący \file{texmf.cnf}. + \subsection{User Profile (inaczej Home -- katalog domowy)} \label{sec:winhome} @@ -1940,6 +1949,8 @@ systemu, jego nazwa została zmieniona na Web-to-C\@. W~1990 roku prace nad projektem przejął Karl Berry wraz z~dziesiątkami współpracowników, w~roku 1997 pałeczkę przejął Olaf Weber, który z powrotem przekazał ją w 2006 roku Karlowi. +%% Sprawdzić wiersze 1958-1962 + \Webc{} działa w systemach Unix, Windows 32-bitowy, (w~tym Mac\,OS\,X), i~innych systemach operacyjnych. System wykorzystuje oryginalne źródła \TeX-owe autorstwa Donalda Knutha @@ -2056,7 +2067,7 @@ lub \samp{../}, to \KPS{} ogranicza się do sprawdzenia, czy ten plik istnieje. \fi %\end{document} \subsubsection{Źródła ścieżek} -\label{Path-sources} +\label{sec:path-sources} Nazwa przeszukiwanej ścieżki może pochodzić z~wielu źródeł. Oto kolejność, w~jakiej \KPS{} ich używa: @@ -2080,7 +2091,7 @@ zobaczyć, używając opcji diagnostyki błędów (patrz ,,Diagnostyka błędów str.~\pageref{sec:debugging}). \subsubsection{Pliki konfiguracyjne} - +\label{sec:configfiles} \KPS{} szuka ścieżek przeszukiwania i~innych definicji w~\emph{plikach konfiguracyjnych} o~nazwach \file{texmf.cnf}. @@ -2088,9 +2099,9 @@ konfiguracyjnych} o~nazwach \file{texmf.cnf}. przez zmienną \envname{TEXMFCNF}, ale nie zalecamy jawnego ustawiania tej, jak i~innych zmiennych w~systemie. -Zamiast tego typowa instalacja \TL{} tworzy plik \file{.../2022/texmf.cnf}, +Zamiast tego typowa instalacja \TL{} tworzy plik \file{.../2023/texmf.cnf}, który w~wyjątkowych wypadkach możemy modyfikować. \\ Głównym plikiem -konfiguracyjnym jest \file{.../2022/texmf-dist/web2c/texmf.cnf}, ale +konfiguracyjnym jest \file{.../2023/texmf-dist/web2c/texmf.cnf}, ale nie powinien być on modyfikowany, gdyż zmiany będą utracone podczas aktualizacji. @@ -2179,7 +2190,7 @@ Rozwinięcia te opisane są w~poniższych podrozdziałach. Jeżeli ścieżka przeszukiwania największego uprzywilejowania (patrz ,,źródła -ścieżek'' na str.~\pageref{Path-sources}) zawiera +ścieżek'' na str.~\pageref{sec:path-sources}) zawiera \emph{dodatkowy dwukropek} (np. na początku, na końcu lub podwójny), to \KPS{} wstawia w~tym miejscu następną ścieżkę przeszukiwania zdefiniowaną w~hierarchii uprzywilejowania. Jeżeli ta wstawiona ścieżka ma dodatkowy dwukropek, to dzieje się dalej to samo. @@ -2874,7 +2885,7 @@ przy głównym współudziale: \item Olafa Webera, który w~poprzednich latach cierpliwie pielęgnował \Webc; \item Gerbena Wierda, który przygotował oryginalne oprogramowanie i~wsparcie - dla Mac\,OS\,X{}; + dla \macOS; \item Grahama Williamsa, który zainicjował prace nad \TeX\ Catalogue. @@ -2887,12 +2898,13 @@ pierwotnych dostępnych dla wszystkich silników; Binaria skompilowali: Marc Baudoin (\pkgname{amd64-netbsd}, \pkgname{i386-netbsd}), -Ken Brown (\pkgname{i386-cygwin}, \pkgname{x86\_64-cygwin}), +Ken Brown (\pkgname{x86\_64-cygwin}), Simon Dales (\pkgname{armhf-linux}), Johannes Hielscher (\pkgname{aarch64-linux}), Akira Kakuto (\pkgname{win32}), Dick Koch (\pkgname{universal-darwin}), Mojca Miklavec (\pkgname{amd64-freebsd}, + \pkgname{armhf-linux}, \pkgname{i386-freebsd}, \pkgname{x86\_64-darwinlegacy}, \pkgname{i386-solaris}, \pkgname{x86\_64-solaris}, @@ -2972,7 +2984,7 @@ Fabrice Popineau. Edycja piąta (marzec 2000) zawierała wiele poprawek i~uzupełnień; zaktualizowano setki pakietów. Szczegółową zawartość pakietów zapisano w~plikach XML. -Główną zmianą w~\TeX\ Live~5 było usunięcie programów, które nie miały +Główną zmianą w~\TL~5 było usunięcie programów, które nie miały statusu {\it public domain}. Zawartość całej płytki powinna odpowiadać ustaleniom Debian Free Software Guidelines (\url{https://www.debian.org/intro/free}). Dołożyliśmy wszelkich starań, aby sprawdzić warunki licencyjne pakietów. @@ -2986,7 +2998,7 @@ zreorganizowane, dzięki czemu wybór jednego z~nich nie tylko instalować potrzebne makra i~fonty, ale też przygotowywać odpowiedni plik \texttt{language.dat}. -\TL~7 (rok 2002) zawierał po raz pierwszy oprogramowanie dla Mac\,OS\,X{} +\TL~7 (rok 2002) zawierał po raz pierwszy oprogramowanie dla \macOS{} 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 @@ -3098,11 +3110,11 @@ i~z~większymi możliwościami indywidualnego dostosowania (patrz (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? M�tne... + %%! hmmm, cały akapit by o strumieniach we-wy? Mętne... -\item Program \textsf{pdfetex} został domyślną ,,maszynę'' dla +\item Program \pkgname{pdfetex} został domyślną ,,maszynę'' dla większości formatów (nie dotyczy to samego Plain \textsf{tex}). -domyślnie, gdy uruchamiamy polecenie \textsf{latex}, \textsf{mex} +domyślnie, gdy uruchamiamy polecenie \pkgname{latex}, \pkgname{mex} itp., generowane są pliki DVI. możliwe jest jednak wykorzystanie w~\LaTeX, \ConTeXt{} itp. m.in. właściwości mikro-typograficznych zaimplementowanych w~\textsf{pdftex}, a~także rozszerzonych cech \eTeX-a @@ -3147,8 +3159,8 @@ cech: plików ograniczone podwójnymi apostrofami, zawierające spacje i~inne znaki, np.: \begin{verbatim} -\input "nazwa_pliku ze spacjami" % plain -\input{"nazwa_pliku ze spacjami"} % latex +\input ,,nazwa_pliku ze spacjami" % plain +\input{,,nazwa_pliku ze spacjami"} % latex \end{verbatim} więcej informacji zawarto w~podręczniku \Webc: \OnCD{texmf-dist/doc/web2c}. @@ -3168,7 +3180,7 @@ więcej informacji zawarto w~podręczniku \Webc: \OnCD{texmf-dist/doc/web2c}. \item Udostępniono nowy program Aleph, który łączył cechy \eTeX\ i~\OMEGA. Skromna dokumentacja jest dostępna na \OnCD{texmf-dist/doc/aleph/base} oraz \url{https://texfaq.org/FAQ-enginedev}. - Format oparty na \LaTeX-u dla programu Aleph nazwano \textsf{lamed}. + Format oparty na \LaTeX-u dla programu Aleph nazwano \pkgname{lamed}. \item Dystrybucja \LaTeX-a została po raz pierwszy zaopatrzona w~nową licencję LPPL, odtąd w~pełni zgodną i~aprobowaną przez zalecenia @@ -3195,7 +3207,7 @@ do formatu graficznego PNG (\url{https://www.ctan.org/pkg/dvipng}). \cmdname{tex}, \cmdname{mf} i~\cmdname{mpost}, nie były od tej pory dostępne -- w~zupełności wystarcza użycie w~wierszu poleceń opcji \optname{-ini}. -\item Dystrybucja nie zawierała binariów dla platformy \textsf{i386-openbsd} +\item Dystrybucja nie zawierała binariów dla platformy \pkgname{i386-openbsd} (głównie z~powodu braku chętnych do wykonania kompilacji). \item W~systemie \textsf{sparc-solaris} należało ustawić zmienną systemową @@ -3203,7 +3215,7 @@ do formatu graficznego PNG (\url{https://www.ctan.org/pkg/dvipng}). Binaria były kompilowane w~C++, ale w~tym systemie brakowało standardowego położenia bibliotek uruchomieniowych. Wiedziano o~tym już wcześniej, nie było to jednak dotychczas udokumentowane. Z~kolei dla systemu - \textsf{mips-irix} wymagana była obecność bibliotek MIPSpro 7.4. + \pkgname{mips-irix} wymagana była obecność bibliotek MIPSpro 7.4. \end{itemize} @@ -3412,7 +3424,7 @@ Strona domowa fontów: \url{https://www.ams.org/tex/amsfonts.html}. Dla Windows i Mac\TeX{} dołączono nowe środowisko\dywiz edytor \TeX{}works. Dla innych platform patrz: \url{https://tug.org/texworks}. -Inspirowany przez edytor TeXShop dla Mac\,OS\,X, \TeX{}works jest +Inspirowany przez edytor TeXShop dla \macOS, \TeX{}works jest wieloplatformowym, łatwym w użyciu środowiskiem pracy. Dla niektórych platform załączono nowy program graficzny Asymptote @@ -3506,7 +3518,7 @@ znacznie przyspieszyło to sam proces instalacji \TL{} z~płytki \DVD. Edycja 2011 zawierała stosunkowo niewiele zmian w porównaniu do poprzednich wydań. -Programy dla Mac\,OS\,X\ (\code{universal-darwin} i \code{x86\_64-darwin}) +Programy dla \macOS\ (\code{universal-darwin} i \code{x86\_64-darwin}) działają od tego momentu tylko dla wersji Leopard i późniejszych. Wersje Panther i Tiger nie będą obsługiwane. @@ -3724,7 +3736,7 @@ dostarczają wsparcie dla języka japońskiego (podobnie jak \prog{up*tex}). Mac\TeX:\ uaktualniono dołączony pakiet Ghostscript dla wparcia {CJK}. Tzw. \textit{The \TeX\ Distribution Preference Pane} działa obecnie w -Yosemite (Mac\,OS\,X~10.10). +Yosemite (\macOS~10.10). Infrastruktura \TL: program \prog{fmtutil} został przekonstruowany tak, aby wczytywać \filename{fmtutil.cnf} zgodnie z~kolejnością drzew katalogów @@ -3833,8 +3845,8 @@ ep\TeX, eup\TeX: Nowe polecenia: \cs{pdfuniformdeviate}, Mac\TeX:\ Począwszy od tego roku będzie zapewniana obsługa -- pod nazwą |x86_64-darwin| -- jedynie tych wersji Mac\TeX-a, dla których Apple wypuszcza łatki bezpieczeństwa; obecnie oznacza to: Yosemite, -El~Capitan, i~Sierra (10.10 i~nowsze). Binariów dla starszych Mac\,OS\,X-ów -nie ma w~Mac\TeX-u, są one jednak wciąż dostępne w~\TeX\ Live +El~Capitan, i~Sierra (10.10 i~nowsze). Binariów dla starszych \macOS-ów +nie ma w~Mac\TeX-u, są one jednak wciąż dostępne w~\TL (|x86_64-darwinlegacy|, \code{i386-darwin}, \code{powerpc-darwin}). Infrastruktura: Drzewo \envname{TEXMFLOCAL} jest teraz domyślnie @@ -3893,12 +3905,12 @@ Lua\TeX: Przygotowanie do przejścia w 2019 r. na wersję Lua 5.3: binaria MetaPost: Poprawiono błędne kierunki ścieżek oraz wyjście w formatach TFM i PNG . Dopuszczono stosowanie plików przekodowujących dla fontów bitmapowych; - identyfikator PDF obecnie nie zależy od nazwy katalogu w którym jest tworzony; poprawki błędów dla \cs{pdfprimitive} i pokrewne. + identyfikator PDF obecnie nie zależy od nazwy katalogu w którym jest tworzony; poprawki błędów dla \cs{pdfprimitive} i~pokrewne. Mac\TeX:\ Zobacz poniżej zmiany obsługiwanych wersji. Ponadto, dla większej klarowności, układ plików zainstalowanych w \ code {/ Applications / TeX /} przez Mac \ TeX \ został zmieniony; teraz ta lokalizacja zawiera cztery programy \GUI (BibDesk, -LaTeXiT, \TeX\ Live Utility, i TeXShop) oraz katalogi z dodatkowymi narzędziami i dokumentacją. +LaTeXiT, \TL Utility, i TeXShop) oraz katalogi z dodatkowymi narzędziami i dokumentacją. \code{tlmgr}: nowe nakładki \code{tlshell} (Tcl/Tk) i \code{tlcockpit} (Java); wyjście w formacie JSON; \code{uninstall} teraz oznacza to samo co @@ -3935,7 +3947,7 @@ używana utworzona do tego celu biblioteka pplib, dzięki czemu znikają zależności od popplera (oraz C ++). Odpowiednio zmienił się też interfejs Lua. MetaPost: Polecenie \code{r-mpost} jest rozpoznawane jako alias do wywołania z~opcją -\code{--restricted} i dodane jest do listy zastrzeżonych poleceń dostępnych domyślnie. +\code{--restricted} i~dodane jest do listy zastrzeżonych poleceń dostępnych domyślnie. Minimalna dokładność to 2 tak dla trybu dziesiętnego jak i binarnego. Tryb binarny nie jest już dostępny w MPlib, ale nadal jest dostępny w~autonomicznej wersji MetaPost-a. @@ -3964,7 +3976,7 @@ i~pobierania przedkłada binaria dostarczane przez system zamiast tych, które Narzędzia: \begin{itemize*} -\item implementacją CWEB w \TeX\ Live jest teraz \code{cwebbin} +\item implementacją CWEB w \TL\ jest teraz \code{cwebbin} (\url{https://ctan.org/pkg/cwebbin}), ze wsparciem dla wielu języków, włącznie z~programem \code{ctwill} do trworzenia miniindeksów. @@ -4025,7 +4037,7 @@ Dvips: Kodowanie bitmapowych czcionek wyjściowych poprawiające efekt w przypa Mac\TeX:\ Mac\TeX\ and \texttt{x86\_64-darwin} wymaga teraz wersji 10.13 lub nowszej (High~Sierra, Mojave, and Catalina); \texttt{x86\_64-darwinlegacy} nadal obsługuje 10.6 i nowsze. -Mac\TeX jest uwierzytelniony a programy uruchamiane z linii poleceń są stabilne co czyni zadość wymaganiom Apple przy instalacji pakietów. BibDesk i~\TeX\ Live Utility +Mac\TeX jest uwierzytelniony a~programy uruchamiane z linii poleceń są stabilne co czyni zadość wymaganiom Apple przy instalacji pakietów. BibDesk i~\TL\ Utility nie są dostępne w~Mac\TeX\ ponieważ nie zostały uwierzytelnione, ale \filename{README} zawiera listę łączy, gdzie można je znaleźć. @@ -4085,7 +4097,7 @@ MetaPost: |mp_solve_rising_cubic| działa zgodnie z~oczekiwaniami. \end{itemize*} -pdf\TeX{}: + pdf\TeX{}: \begin{itemize*} \item Dodano nowe polecenia pierwotne \cs{pdfrunninglinkoff} i~\cs{pdfrunninglinkon}; np. dla wyłączenia generowania łączy @@ -4145,10 +4157,8 @@ danych odpowiednio lokalnego i zdalnego katalogów; pełne raportowanie podkomend. \end{itemize*} - \htmlanchor{news} -\subsection{Wydanie aktualne: 2022} -\label{sec:tlcurrent} - + +\subsubsection{Wydanie 2022} Ogólnie: \begin{itemize} @@ -4218,7 +4228,7 @@ Kpathsea: Pierwsza ścieżka zwrócona przez \texttt{kpsewhich -all} jest teraz \item \code{install-tl}: jeśli pobieranie lub instalacja konkretnego pakietu nie powiedzie się, kontynuuje proces automatycznie, a~na koniec ponawia próbę, ale tylko raz. \end{itemize*} -Mac\TeX{}: Mac\TeX{} i folder z jego binariami \texttt{universal-darwin} wymaga obecności macOS 10.14 lub wyższego (Mojave, Catalina, Big~Sur, Monterey). +Mac\TeX{}: Mac\TeX{} i folder z jego binariami \texttt{universal-darwin} wymaga obecności \macOS 10.14 lub wyższego (Mojave, Catalina, Big~Sur, Monterey). Dostępne tylko dla Unixowego \texttt{install-tl} binaria w~folderze |x86_64-darwinlegacy| obsługują wersję 10.6 (Snow~Leopard) i~nowsze. @@ -4227,6 +4237,93 @@ Jednakże, w~przyszłym (2023) roku planujemy zmienić system Windows z~32-bitowego na 64-bitowy. Niestety nie jesteśmy w stanie obsługiwać obu systemów jednocześnie. + + \htmlanchor{news} +\subsection{Wydanie 2023} +\label{sec:tlcurrent} + +Windows: +Tak jak zapowiadaliśmy, \TL{} zawiera teraz binaria dla Windows 64-bitowych, zamiast dla 32-bitowych. Nową nazwą katalogu jest \texttt{bin/windows} ponieważ nie było właściwe umieszczanie 64-bitowych binariów w katalogu z nazwą ,,32". Zdajemy sobie sprawę, że ta zmiana będzie wymagała dodatkowej pracy od użytkowników Windows, ale nie było lepszego wyboru. Zobacz stronę \TL{} dla Windows (\url{https://tug.org/texlive/windows.html}). + + Rozszerzenia między silnikami (z wyjątkiem oryginalnych \TeX{} i e-TeX{}): + \cs{special} poprzedzające nowe słowo kluczowe +,,\texttt{shipout}'' opóźnia rozwinięcie tokenu argumentu +do czasu określonego przez \cs{shipout}, tak jak +non-\verb|\immediate\write|.{\raggedright\par} + + +\noindent ep\TeX{}, eup\TeX{}:\begin{itemize*} +\item ,,Raw'' (u)ptex nie jest już tworzony; (u)ptex działa teraz w trybie zgodności z +e(u)ptex's. To samo dotyczy narzędzi p\TeX{} wymienionych poniżej. +\item Nowe polecenia pierwotne: \cs{tojis}, \cs{ptextracingfonts}, +\cs{ptexfontname}. +\item Dla \cs{font}, nowa składnia JIS/UCS jest obsługiwana. +\end{itemize*} + +\noindent Lua\TeX: \begin{itemize*} +\item Nowe polecenie pierwotne \cs{variablefam} pozwalające znakom matematycznym zachować swoją klasę jednocześnie z adaptacją do użytej rodziny fontów. +\item Ulepszono pole przypisu r2l % improved r2l annotation areas +\item Rozszerzenia między silnikami ,,late \cs{special}'' opisane powyżej. +\end{itemize*} + +\noindent MetaPost: Poprawione błędy. \texttt{svg->dx} i \texttt{svg->dy} są teraz dwa, dla większej precyzji; \verb|mp_begin_iteration| zaktualizowany, +memory leak w \texttt{mplib} poprawiony. + +\noindent pdf\TeX{}: \begin{itemize*} +\item Nowe polecenie pierwotne \cs{pdfomitinfodict} żeby ominąć zupełnie słownik \texttt{/Info}. +\item Nowe polecenie pierwotne \cs{pdfomitprocset} aby kontrolować pomijanie tablicy \texttt{/ProcSet}: \texttt{/ProcSet} jest dodawany, jeżeli ten parametr jest ujemny, lub jeżeli ten parametr jest równy zero i pdftex generuje plik PDF~1.x. +\item Z \cs{pdfinterwordspaceon}, jeżeli w bieżącym kodowaniu na miejscu 32 znajduje się znak \texttt{/space}, w przeciwnym wypadku użyty jest znak + \texttt{/space} z nowego domyślnego fontu \texttt{pdftexspace}. Ten domyślny font może być nadpisany przez nowe polecenie pierwotne +\cs{pdfspacefont}. Ta sama nowa procedura jest użyta dla \cs{pdffakespace}. +\end{itemize*} + +\noindent p\TeX{} i inni: \begin{itemize*} +\item Jak wspomnieliśmy powyżej, teraz \texttt{ptex} uruchamia \texttt{eptex} w trybie zgodności. + +\item Narzędzia p\TeX{} (pbibtex, pdvitype, ppltotf, ptftopl) też działają w trybie zgodności. +\end{itemize*} + +\noindent Xe\TeX: poprawiony błąd w obliczaniu \cs{topskip} i \cs{splittopskip} +kiedy \cs{XeTeXupwardsmode} jest aktywny; opisany powyżej dla wszystkich silników +,,late \cs{special}''. + +\noindent Dvipdfmx: nowy parametr \texttt{--pdfm-str-utf8} do tworzenia pdfmark i/lub bookmark. + +\noindent \BibTeX{}u: \begin{itemize*} +\item Ten wariant Bib\TeX{} jest w większości kompatybilny z \BibTeX, + z lepszym (opartym na Unicode) wspomaganiem wielu języków. Mamy go w \TL{} od kilku lat. +\item W tym roku zostało dodanych więcej funkcji do obsługi języków CJK, niektóre rozszerzone z~japońskiego (u)pbibtex i z innych programów. +\end{itemize*} + +\noindent Kpathsea: wspomaganie odczytywania (zgadywania) kodowania plików wejściowych dla platform Unix-owych, tak jak to działa dla Windows; włączone dla (\texttt{e})\texttt{p}(\texttt{la})\texttt{tex}, \texttt{pbibtex}, \texttt{mendex}. + +\noindent \code{tlmgr} i infrastruktura: \begin{itemize*} +\item domyślny dla interfejsu tekstowego na \macOS, +\item instaluje najpierw podstawowe pakiety, następnie pozostałe, +\item sprawdza ilość potrzebnego miejsca na dysku. +\end{itemize*} + +\noindent Mac\TeX{}: \begin{itemize*} +\item Mac\TeX{} i jego katalog binarów \texttt{universal-darwin} +wymaga \macOS\ 10.14 lub wyższego (Mojave, Catalina, Big~Sur, Monterey, +Ventura). Katalog binarów \texttt{x86\_64-darwinlegacy}, dostępny tylko z~Unix \texttt{install-tl}, wspiera 10.6 (Snow~Leopard) i późniejsze. + +\item Pakiet GUI w Mac\TeX{} zawiera teraz \texttt{hintview}, przeglądarkę \macOS\ +dla dokumentów HINT (utworzonych przez silniki \texttt{hitex} i +\texttt{hilatex} dla urządzeń mobilnych; zobacz stronę Hi\TeX{} +\url{https://hint.userweb.mwn.de/hint/hitex.html}). Pakiet GUI nie instaluje już katalogu z dokumentami, zastępując go krótkim +\texttt{READ~ME} dla nowych użytkowników i stroną o ~texttt{hintview}. + +\item Katalog \texttt{Extras} o dodatkowych programach \TeX-owych znajdujących się na DVD został zastąpiony dokumentem zawierającym linki do stron z plikami do pobrania. +\end{itemize*} + +\noindent Platforms: \begin{itemize*} +\item Jak wspomniano powyżej, nowy katalog z binariami dla \texttt{windows} zawiera binaria dla 64-bit Windows i +\item katalog \texttt{bin/win32} został usunięty, gdyż nie można obsługiwać równolegle Windows 32-bit i 64-bit. +\item Również katalog z binariami dla \texttt{i386-cygwin} został usunięty, ponieważ Cygwin nie wspiera już i386. +\end{itemize*} + + %\newpage % zbyt mało tekstu przepływało na ostatnią stronę ... \subsection{Przyszłe wersje} |