From 059cab71c68a3fbee36f60e8208d4a47d11c6b60 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Thu, 26 Aug 2021 03:02:29 +0000 Subject: CTAN sync 202108260302 --- macros/latex/contrib/polski/czytaj.txt | 261 ++++++++++++++++----------------- 1 file changed, 127 insertions(+), 134 deletions(-) (limited to 'macros/latex/contrib/polski/czytaj.txt') diff --git a/macros/latex/contrib/polski/czytaj.txt b/macros/latex/contrib/polski/czytaj.txt index e04af5148c..88048359bb 100644 --- a/macros/latex/contrib/polski/czytaj.txt +++ b/macros/latex/contrib/polski/czytaj.txt @@ -6,157 +6,152 @@ * * * Copyright (C) 1994 by Mariusz Olko. * * Copyright (C) 1997 by Mariusz Olko and Marcin Woli\'nski. * -* Copyright (C) 2000,2002,2003,2007 by Marcin Woli\'nski. * +* Copyright (C) 2000,2002,2003,2007,2017,2021 by Marcin Woli\'nski. * * * ********************************************************************** ---- Informacje ogólne +——— Informacje ogĂłlne -Pakiet 'Polski' dostarcza narzędzi potrzebnych do składu dokumentów -w języku polskim LaTeXem 2e. Główne cechy pakietu +Pakiet ‹Polski› dostarcza narzÄ™dzi potrzebnych do skĹ‚adu dokumentĂłw +w jÄ™zyku polskim LaTeXem 2e. GĹ‚Ăłwne cechy pakietu -* umożliwia skład czcionkami `PL' pochodz±cymi z pakietu MeX -* umożliwia skład czcionkami w ukladzie T1 znanymi jako czcionki EC -* umożliwia skład czcionkami w ukladzie QX, w szczególno¶ci krojami - TeX Gyre (dawniej 'Quasi') tworzonymi przez JNS Team -* umożliwia skompilowanie dokumentu nawet wtedy, gdy dostępne s± - jedynie czcionki `CM' -* wykorzystuje polskie wzorce przenoszenia -* działa z _formatem_ Babel z polskimi wzorcami przenoszenia -* wspomaga prace z różnymi wej¶ciowymi stronami kodowymi -* wspomaga `notację ciachow±' polskich znaków -* posiada tryb 99.99% zgodno¶ci z LaMeXem (polsk± adaptacj± LaTeXa 2.09) +• umoĹĽliwia skĹ‚ad „czcionkami PL” pochodzÄ…cymi z pakietu MeX +• umoĹĽliwia skĹ‚ad czcionkami w ukladzie T1 (europejskim) +• umoĹĽliwia skĹ‚ad czcionkami w ukladzie QX, w szczegĂłlnoĹ›ci krojami + TeX Gyre (dawniej Quasi) tworzonymi przez JNS Team +• umoĹĽliwia skompilowanie dokumentu nawet wtedy, gdy dostÄ™pne sÄ… + jedynie oryginalne czcionki Computer Modern +• wykorzystuje polskie wzorce przenoszenia +• dziaĹ‚a z _formatem_ Babel z polskimi wzorcami przenoszenia +• wspomaga prace z różnymi wejĹ›ciowymi stronami kodowymi +• wspomaga „notacjÄ™ ciachową” polskich znakĂłw +• posiada tryb 99.99% zgodnoĹ›ci z LaMeXem (polskÄ… adaptacjÄ… LaTeXa 2.09) -Dodatkowo doł±czone s± dwa pakiety, które pozwol± posłużyć się +Dodatkowo doĹ‚Ä…czone sÄ… dwa pakiety, ktĂłre pozwolÄ… posĹ‚uĹĽyć siÄ™ LaTeXem 2e w najbardziej nawet nieprzyjaznym otoczeniu: -* pakiet plprefix pozwala na uzyskanie polskich liter przy pomocy +• pakiet plprefix pozwala na uzyskanie polskich liter przy pomocy notacji prefiksowej z dowolnie wybranym prefiksem (pomocny np. do robienia wydrukow z CWEBa). -* pakiet OT1patch dorabia ogonki wg najlepszych znanych standardów do +• pakiet OT1patch dorabia ogonki wg najlepszych znanych standardĂłw do oryginalnych czcionek CM (kod Leszka Holenderskiego). -Nie zachęcamy do stosowania tych pakietow, poza szczególnymi -przypadkami. S±dzimy, że powody do ich stosowania znikły w -większo¶ci systemów komputerowych co najmniej 10 lat temu. +Nie zachÄ™camy do stosowania tych pakietow, poza szczegĂłlnymi +przypadkami. SÄ…dzimy, ĹĽe powody do ich stosowania znikĹ‚y w +wiÄ™kszoĹ›ci systemĂłw komputerowych co najmniej 10 lat temu. - Obecnie nie ma powodów ze strony samego TeXa żeby nie używać dla -polskich znaków naturalnej notacji o¶miobitowej. Notacja prefiksowa -jest w dzisiejszych czasach nienaturalnym dziwactwem. Wyj±tek -stanowi± jeszcze pewne nieprzyjazne ¶rodowiska obliczeniowe, w których -nie sposób wy¶wietlić polskich znaków. Na tę okoliczno¶ć polski.sty -oferuje notację ciachow± (polecenie \prefixing). + Obecnie nie ma powodĂłw ze strony samego TeXa ĹĽeby nie uĹĽywać dla +polskich znakĂłw naturalnej notacji oĹ›miobitowej. Notacja prefiksowa +jest w dzisiejszych czasach nienaturalnym dziwactwem. WyjÄ…tek +stanowiÄ… jeszcze pewne nieprzyjazne Ĺ›rodowiska obliczeniowe, w ktĂłrych +nie sposĂłb wyĹ›wietlić polskich znakĂłw. Na tÄ™ okoliczność polski.sty +oferuje notacjÄ™ ciachowÄ… (polecenie \prefixing). - Polskie znaki obecne w fontach zawsze będ± dawać lepsze efekty niż -stosowanie protez zawartych w OT1patch. Poza tym używanie OT1patch -nie pozwala na pełne zastosowanie polskich wzorców przenoszenia. + Polskie znaki obecne w fontach zawsze bÄ™dÄ… dawać lepsze efekty niĹĽ +stosowanie protez zawartych w OT1patch. Poza tym uĹĽywanie OT1patch +nie pozwala na peĹ‚ne zastosowanie polskich wzorcĂłw przenoszenia. ---- Licencja +——— Licencja -'Polski' stanowi oprogramowanie swobodne, może być dystrybuowany w -zgodzie z licencj± LaTeX Project Public License (zob. plik lppl.txt w +‹Polski› stanowi oprogramowanie swobodne, moĹĽe być dystrybuowany w +zgodzie z licencjÄ… LaTeX Project Public License (zob. plik lppl.txt w dystrybucji LaTeXa; CTAN:macros/latex/base/lppl.txt). ---- Pliki wchodzace w skład pakietu +——— Pliki wchodzace w skĹ‚ad pakietu -W skład pakietu wchodzi kilka plików zawieraj±cych udokumentowane -(w większosci :-) Ľródła makr. +W skĹ‚ad pakietu wchodzi kilka plikĂłw zawierajÄ…cych udokumentowane +(w wiÄ™kszosci :-) ĹşrĂłdĹ‚a makr. -* polski.dtx - zawiera Ľródła pakietu polski -* polski.ins - główny skrypt instalacyjny -* strony.dtx - plik z wej¶ciowymi stronami kodowymi dla LaTeXa oraz - definicj± układu czcionek OT4 -* plfonts.fdd - definicje czcionek `PL' do wykorzystania w LaTeXu -* plprefix.dtx - zawiera Ľródła pakietu pozwalaj±cego na uzyskiwanie - polskich liter za pomoc± `notacji prefiksowej' -* plprefix.ins - skrypt instalacyjny dla plprefix.sty -* ot1patch.dtx - zawiera Ľródła pakietu dorabiaj±cego ogonki +• polski.dtx — zawiera ĹşrĂłdĹ‚a pakietu polski +• polski.ins — gĹ‚Ăłwny skrypt instalacyjny +• strony.dtx — plik z wejĹ›ciowymi stronami kodowymi dla LaTeXa oraz + definicjÄ… ukĹ‚adu czcionek OT4 +• plfonts.fdd — definicje czcionek PL do wykorzystania w LaTeXu +• plprefix.dtx — zawiera ĹşrĂłdĹ‚a pakietu pozwalajÄ…cego na uzyskiwanie + polskich liter za pomocÄ… „notacji prefiksowej” +• plprefix.ins — skrypt instalacyjny dla plprefix.sty +• ot1patch.dtx — zawiera ĹşrĂłdĹ‚a pakietu dorabiajÄ…cego ogonki do oryginalnych czcionek Computer Modern -* ot1patch.ins - skrypt instalacyjny dla ot1patch.sty -* czytaj.txt - ten plik -* readme.txt - opis instalacji po angielsku -* conowego.txt - lista zmian w pakiecie -* sample-polski.tex - przykładowy dokument -* sample-rysunek{.mp,1.mps} - rysunek do przykładowego dokumentu +• ot1patch.ins — skrypt instalacyjny dla ot1patch.sty +• czytaj.txt — ten plik +• readme.txt — opis instalacji po angielsku +• conowego.txt — lista zmian w pakiecie +• sample-polski.tex — przykĹ‚adowy dokument +• sample-rysunek{.mp,1.mps} — rysunek do przykĹ‚adowego dokumentu ---- Instalacja pakietu +——— Instalacja pakietu -Po rozpakowaniu archiwum należy wygenerować wszystkie potrzebne pliki -uruchamiaj±c skrypt polski.ins +Po rozpakowaniu archiwum naleĹĽy wygenerować wszystkie potrzebne pliki +uruchamiajÄ…c skrypt polski.ins tex polski.ins -Skrypt wygeneruje na pocz±tek podstawowe pliki, tzn. pakiet polski.sty -oraz opisy wejsciowych stron kodowych. Następnie użytkownik jest -pytany czy ma zainstalowane czcionki `PL' pochodz±ce z instalacji -MeXa. Je¶li czcionki sa zainstalowane, generowane s± pliki -definiuj±ce polskie czcionki dla LaTeXa. Je¶li czcionki nie s± -zainstalowane w systemie, należy zadbać, aby nie było też pliku -ot4cmr.fd na ¶cieżce LaTeXa, aby nie wprowadzic w bł±d procedury -rozpoznaj±cej ¶rodowisko w pakiecie polski.sty. Na zakończenie należy -skopiować pliki *.fd *.sty *.def *.cfg do katalogu czytanego przez -TeXa. - -Do poprawnego składu po polsku konieczna jest obecno¶ć polskich -wzorców przenoszenia wyrazów w tzw. formacie LaTeXa. Zestaw wzorców -przenoszenia wbudowany w format zależy od zawarto¶ci pliku -language.dat (zob. dokumentację LaTeXa). Współczesne implementacje -TeXa zawieraj± pomocnicze narzędzia automatyzuj±ce generowanie -formatów. Zwykle więc wystarczy w narzędziu konfiguracyjnym wybrać -czę¶ć zatytułowan± 'Języki' i zaznaczyć odpowiednie wzorce +Skrypt wygeneruje na poczÄ…tek podstawowe pliki, tzn. pakiet polski.sty +oraz opisy wejsciowych stron kodowych. NastÄ™pnie generowane sÄ… pliki +opisujÄ…ce fonty Computer Modern w polskim ukĹ‚adzie OT4 (tzw. „fonty +PL”). Na zakoĹ„czenie naleĹĽy skopiować pliki *.fd *.sty *.def *.cfg do +katalogu czytanego przez TeXa. + +Do poprawnego skĹ‚adu po polsku konieczna jest obecność polskich +wzorcĂłw przenoszenia wyrazĂłw w tzw. formacie LaTeXa. Zestaw wzorcĂłw +przenoszenia wbudowany w format zaleĹĽy od zawartoĹ›ci pliku +language.dat (zob. dokumentacjÄ™ LaTeXa). Współczesne implementacje +TeXa zawierajÄ… pomocnicze narzÄ™dzia automatyzujÄ…ce generowanie +formatĂłw. Zwykle wiÄ™c wystarczy w narzÄ™dziu konfiguracyjnym wybrać +część zatytuĹ‚owanÄ… „JÄ™zyki” i zaznaczyć odpowiednie wzorce przenoszenia. -W systemie emTeX (pod MS DOS-em) do generowania formatu należało użyć +W systemie emTeX (pod MS DOS-em) do generowania formatu naleĹĽaĹ‚o uĹĽyć polecenia: tex386 /i/o/r/8 /mt13000 latex.ltx ---- Dokumentacja +——— Dokumentacja -Pliki dtx zawieraj± teksty makr wraz z dokumentacj±. S± one gotowe -do wydruku po przetworzeniu przez LaTeXa. Instrukcję posługiwania się -pakietem polski można uzyskać uruchamiaj±c +Pliki dtx zawierajÄ… teksty makr wraz z dokumentacjÄ…. SÄ… one gotowe +do wydruku po przetworzeniu przez LaTeXa. InstrukcjÄ™ posĹ‚ugiwania siÄ™ +pakietem polski moĹĽna uzyskać uruchamiajÄ…c latex polski.dtx -a dalej używaj±c swojego ulubionego programu do podgl±du. +a dalej uĹĽywajÄ…c swojego ulubionego programu do podglÄ…du. ---- Osmiobitowe wprowadzanie polskich liter +——— Osmiobitowe wprowadzanie polskich liter -Aby złożyć w TeXu dokument zapisany w tzw. stronie kodowej trzeba -wskazać TeXowi, w jakiej stronie dokument jest zapisany. Możliwe s± +Aby zĹ‚oĹĽyć w TeXu dokument zapisany w tzw. stronie kodowej trzeba +wskazać TeXowi, w jakiej stronie dokument jest zapisany. MoĹĽliwe sÄ… dwa sposoby: -* Posłużenie się mechanizmem przekodowywania znaków na postać -wewnętrzn± przez samego TeXa. W chwili obecnej stosowne wsparcie jest +• PosĹ‚uĹĽenie siÄ™ mechanizmem przekodowywania znakĂłw na postać +wewnÄ™trznÄ… przez samego TeXa. W chwili obecnej stosowne wsparcie jest obecne co najmniej w web2c, teTeXu, TeXlive, fpTeXu, mikTeXu i emTeXu. -* Zastosowanie standardowego pakietu inputenc. +• Zastosowanie standardowego pakietu inputenc. -Przekodowywanie nie pozwala na pracę z kilkoma wej¶ciowymi stronami -kodowymi w jednym dokumencie ani fontami o różnych układach polskich -znaków. Jest za to bardziej bezpieczne ze wzgledu na współpracę z -programami zewnętrznymi (np. MakeIndex). Należy również zwrócić -uwagę, że przekodowanie na poziomie implementacji jest zależne od -układu stosowanych fontów. Definicje przekodowania przygotowane dla -fontów PL z konieczno¶ci mapuj± tylko ,,polskie znaki''. Dla +Przekodowywanie nie pozwala na pracÄ™ z kilkoma wejĹ›ciowymi stronami +kodowymi w jednym dokumencie ani fontami o różnych ukĹ‚adach polskich +znakĂłw. Jest za to bardziej bezpieczne ze wzgledu na współpracÄ™ z +programami zewnÄ™trznymi (np. MakeIndex). NaleĹĽy rĂłwnieĹĽ zwrĂłcić +uwagÄ™, ĹĽe przekodowanie na poziomie implementacji jest zaleĹĽne od +ukĹ‚adu stosowanych fontĂłw. Definicje przekodowania przygotowane dla +fontĂłw PL z koniecznoĹ›ci mapujÄ… tylko „polskie znaki”. Dla kontrastu definicje stron kodowych pakietu inputenc (np. cp1250 czy -cp852) obejmuj± wszystkie znaki strony kodowej (wł±cznie ze znakami -nieliterowymi). Pakiet inputenc pozwala również przetwarzać dokumenty +cp852) obejmujÄ… wszystkie znaki strony kodowej (wĹ‚Ä…cznie ze znakami +nieliterowymi). Pakiet inputenc pozwala rĂłwnieĹĽ przetwarzać dokumenty zakodowane w Unikodzie zapisanym w formie UTF-8 (opcja utf8). -Oto szczegóły specyficzne dla implementacji: +Oto szczegóły specyficzne dla implementacji: ------- web2c, teTeX, TeXlive, fpTeX, mikTeX +—————— web2c, teTeX, TeXlive, fpTeX, mikTeX -W tych implementacjach kodowanie dokumentu zadaje się za pomoc± opcji ---translate-file wskazuj±cej plik definiuj±cy przekodowanie. Na -przykład +W tych implementacjach kodowanie dokumentu zadaje siÄ™ za pomocÄ… opcji +--translate-file wskazujÄ…cej plik definiujÄ…cy przekodowanie. Na +przykĹ‚ad latex --translate-file=il2-pl dokument.tex przetwarza dokument z polskimi znakami zapisanymi w kodzie ISO -Latin-2. Można również, i jest to rozwi±zanie zalecane, zadać kod w -pierwszej linii dokumentu za pomoc± następuj±cego ,,magicznego'' +Latin-2. MoĹĽna rĂłwnieĹĽ, i jest to rozwiÄ…zanie zalecane, zadać kod w +pierwszej linii dokumentu za pomocÄ… nastÄ™pujÄ…cego „magicznego” komentarza: %&latex --translate-file=il2-pl @@ -165,66 +160,64 @@ W tym przypadku do przetwarzania dokumentu wystarczy latex dokument.tex -W standardowej dystrybucji zawarta jest spora gar¶ć plików -definiuj±cych przekodowanie. Pliki te maj± rozszerzenie .tcx i -rezyduj± w podkatalogu texmf/web2c korzenia instalacji. S± to pliki -tekstowe, o realizowanym przekodowaniu można dowiedzieć się z +W standardowej dystrybucji zawarta jest spora garść plikĂłw +definiujÄ…cych przekodowanie. Pliki te majÄ… rozszerzenie .tcx i +rezydujÄ… w podkatalogu texmf/web2c korzenia instalacji. SÄ… to pliki +tekstowe, o realizowanym przekodowaniu moĹĽna dowiedzieć siÄ™ z komentarza w pierwszych liniach pliku. ------- emTeX +—————— emTeX -W przypadku pracy z emTeXem przekodowanie musi zostać ,,zaszyte'' w -plik formatu. Jeżeli ma się do czynienia z dokumentami w różnych -stronach kodowych, konieczny jest oddzielny plik formatu dla każdej -strony. +W przypadku pracy z emTeXem przekodowanie musi zostać „zaszyte” w plik +formatu. JeĹĽeli ma siÄ™ do czynienia z dokumentami w różnych stronach +kodowych, konieczny jest oddzielny plik formatu dla kaĹĽdej strony. -Pliki przekodowań dla polskich znaków dla emTeXa dostarczane s± z -MeXem. Na przykład poniższe polecenie generuje format LaTeX z +Pliki przekodowaĹ„ dla polskich znakĂłw dla emTeXa dostarczane sÄ… z +MeXem. Na przykĹ‚ad poniĹĽsze polecenie generuje format LaTeX z kodowaniem Mazovii: tex386 /i/o/r /cmaz2pl /mt13000 latex.ltx ------- implementacje nie zapewniaj±ce przekodowania +—————— implementacje nie zapewniajÄ…ce przekodowania -W przypadku korzystania z takiej implementacji (lub chęci użycia w -jednym dokumencie różnie zakodowanych fragmentów) należy do preambuły -dokumentu dodać wywołanie pakietu inputenc z opcj± wskazuj±c± stronę -kodow±, np. +W przypadku korzystania z takiej implementacji (lub chÄ™ci uĹĽycia w +jednym dokumencie różnie zakodowanych fragmentĂłw) naleĹĽy do preambuĹ‚y +dokumentu dodać wywoĹ‚anie pakietu inputenc z opcjÄ… wskazujÄ…cÄ… stronÄ™ +kodowÄ…, np. \documentclass{article} \usepackage{polski} \usepackage[mazovia]{inputenc} Podczas instalacji pakietu Polski tworzone sa pliki ze stronami kodowymi: -mazovia - dla popularnej (kiedy¶) strony kodowej na PCetach. -amigapl - dla polskiej strony kodowej używanej na Amidze +mazovia — dla popularnej (kiedyĹ›) strony kodowej na PCetach. +amigapl — dla polskiej strony kodowej uĹĽywanej na Amidze -Ponadto w dystrybucji LaTeXa zawarte s± następuj±ce strony -interesuj±ce dla polskiego użytkownika: +Ponadto w dystrybucji LaTeXa zawarte sÄ… nastÄ™pujÄ…ce strony +interesujÄ…ce dla polskiego uĹĽytkownika: -cp1250 - dla Windowsowej strony centralnoeuropejskiej CP1250 -latin2 - kodowanie ISO 8859-2 (Latin-2) -cp852 - dla DOS-owej strony CP852 (tzw. IBM Latin-2) -macce - dla strony centralnoeuropejskiej na komputerach Macintosh -utf8 - kodowanie UTF-8 (Unikod; to w zasadzie nie jest `strona - kodowa', ale zasada użycia jest ta sama) +cp1250 — dla Windowsowej strony centralnoeuropejskiej CP1250 +latin2 — kodowanie ISO 8859-2 (Latin-2) +cp852 — dla DOS-owej strony CP852 (tzw. IBM Latin-2) +macce — dla strony centralnoeuropejskiej na komputerach Macintosh +utf8 — kodowanie UTF-8 (Unikod; to w zasadzie nie jest strona + kodowa, ale zasada uĹĽycia jest ta sama) -Większo¶ć instalacji TeXowych czyta osmiobitowe znaki zawarte w -dokumentach. Niektóre starsze implementacje wymagaj± użycia do tego +WiÄ™kszość instalacji TeXowych czyta osmiobitowe znaki zawarte w +dokumentach. NiektĂłre starsze implementacje wymagajÄ… uĹĽycia do tego specjalnej opcji podczas generowania formatu. ---- Podziękowania +——— PodziÄ™kowania -* Marek Ryćko i Bogusław Jackowski stworzyli MeXa i LaMeXa -* Robert Ramiega przysłał tablicę kodow± używan± na Amidze -* Staszek Wawrykiewicz napisał dokument przykładowy i, co ważniejsze, - zanurzył cało¶ć w kontekst TeXlive +• Marek Ryćko i BogusĹ‚aw Jackowski stworzyli MeXa i LaMeXa +• Robert Ramiega przysĹ‚aĹ‚ tablicÄ™ kodowÄ… uĹĽywanÄ… na Amidze +• Staszek Wawrykiewicz napisaĹ‚ dokument przykĹ‚adowy i, co waĹĽniejsze, + zanurzyĹ‚ caĹ‚ość w kontekst TeXlive ********************************************************************** Marcin Woli\'nski mailto:wolinski@gust.org.pl - http://www.mimuw.edu.pl/~wolinski ********************************************************************** -- cgit v1.2.3