From e5fe07f6ccccd3508620e2159b9a6367100c50ea Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 23 Dec 2007 01:10:35 +0000 Subject: polski 1.3.2 update (22dec07) git-svn-id: svn://tug.org/texlive/trunk@5828 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/polski/czytaj.txt | 237 +++++++++++++------------- 1 file changed, 119 insertions(+), 118 deletions(-) (limited to 'Master/texmf-dist/doc/latex/polski/czytaj.txt') diff --git a/Master/texmf-dist/doc/latex/polski/czytaj.txt b/Master/texmf-dist/doc/latex/polski/czytaj.txt index 15c53504392..e04af5148c1 100644 --- a/Master/texmf-dist/doc/latex/polski/czytaj.txt +++ b/Master/texmf-dist/doc/latex/polski/czytaj.txt @@ -1,165 +1,163 @@ ********************************************************************** * * -* PLaTeX czyli LaTeX2e po polsku * +* Pakiet Polski czyli LaTeX2e po polsku * * * * * * * * Copyright (C) 1994 by Mariusz Olko. * * Copyright (C) 1997 by Mariusz Olko and Marcin Woli\'nski. * -* Copyright (C) 2000,2002,2003 by Marcin Woli\'nski. * +* Copyright (C) 2000,2002,2003,2007 by Marcin Woli\'nski. * * * ********************************************************************** ---- Informacje ogolne +--- Informacje ogólne -Pakiet PLaTeX dostarcza narzedzi potrzebnych do skladu dokumentow -w jezyku polskim LaTeXem 2e. Glowne cechy pakietu +Pakiet 'Polski' dostarcza narzędzi potrzebnych do składu dokumentów +w języku polskim LaTeXem 2e. Główne cechy pakietu -* wspiera sklad czcionkami `pl' pochodzacymi z pakietu MeX -* wspiera sklad czcionkami w ukladzie T1 znanymi jako czcionki EC -* wspiera sklad czcionkami w ukladzie QX, w szczegolnosci krojami - 'Quasi' tworzonymi przez JNS Team -* umozliwia skompilowanie dokumentu nawet wtedy gdy dostepne sa +* 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' -* wspolpracuje z polskimi wzorcami przenoszenia -* dziala z _formatem_ Babel z polskimi wzorcami przenoszenia -* pozwala wygenerowac format LaTeX z polskimi wzorcami przenoszenia, - zgodny z Bablem ale bez jego makr -* wspomaga notacje `ciachowa' -* posiada tryb 99.99% zgodnosci z LaMeXem -* wspomaga prace z roznymi wejsciowymi stronami kodowymi - -Dodatkowo dolaczone sa dwa style, ktore pozwola posluzyc sie -LaTeXem 2e w najbardziej nawet nieprzyjaznym otoczeniu. - -* styl plprefix pozwala na uzyskanie polskich liter przy pomocy +* 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ę +LaTeXem 2e w najbardziej nawet nieprzyjaznym otoczeniu: + +* pakiet plprefix pozwala na uzyskanie polskich liter przy pomocy notacji prefiksowej z dowolnie wybranym prefiksem (pomocny np. do robienia wydrukow z CWEBa). -* styl OT1patch dorabia ogonki wg najlepszych znanych standardow do +* pakiet OT1patch dorabia ogonki wg najlepszych znanych standardów do oryginalnych czcionek CM (kod Leszka Holenderskiego). -Nie zachecamy do stosowania tych pakietow, poza szczegolnymi -przypadkami. +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 -staje się z wolna nienaturalnym dziwactwem. Wyjątek stanowią jeszcze -pewne nieprzyjazne środowiska obliczeniowe. Na tę okoliczność -polski.sty oferuje notację ciachową. Niezaleznie od opinii na dobor -takiego czy innego znaku jako prefix uwazamy, ze im mniej sprzecznych -,,standardow'' tym lepiej. Jeśli trzeba, używajcie ciacha! - - Polskie znaki sa powszechnie dostepne w MeXu od lat a obecnie -rowniez w zestawie czcionek EC dostepnych w wiekszosci dystrybucji -TeXa i zawsze beda dawac lepsze efekty niz stosowanie protez zawartych -w OT1patch. Poza tym uzywanie OT1patch nie pozwala na pelne -zastosowanie polskich wzorcow przenoszenia. +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. --- Licencja -PLaTeX stanowi oprogramowanie swobodne, może być dystrybuowany 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 sklad pakietu +--- Pliki wchodzace w skład pakietu -W sklad pakietu wchodzi kilka plikow zawierajacych udokumentowane -(w wiekszosci :-) zrodla makr. +W skład pakietu wchodzi kilka plików zawierających udokumentowane +(w większosci :-) źródła makr. -* polski.dtx - zawiera zrodla pakietu polski -* strony.dtx - plik z wejsciowymi stronami kodowymi dla LaTeXa oraz - definicja ukladu czcionek OT4 +* 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 -* platex.ins - glowny skrypt instalacyjny -* polski.ins - skrypt generujacy podstawowe pliki pakietu -* plprefix.dtx - zawiera zrodla stylu pozwalajacego na uzyskiwanie - polskich liter przy pomocy znakow innych niz / +* 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 zrodla stylu dorabiajacego ogonki - do czcionek CM +* 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 --- Instalacja pakietu -Po rozpakowaniu pakietu nalezy wygenerowac wszystkie potrzebne pliki -uruchamiajac skrypt platex.ins - tex platex.ins -Skrypt wygeneruje na poczatek podstawowe pliki pakietu tzn. styl -polski.sty, plik konfigurujacy wzorce przenoszenia wyrazow wczytywane -przez LaTeX oraz opisy wejsciowych stron kodowych. Nastepnie -uzytkownik jest pytany czy ma zainstalowane czcionki `PL' pochodzace z -instalacji MeXa. Jesli czcionki sa zainstalowane, generowane sa pliki -definiujace polskie czcionki dla LaTeXa. Jesli czcionki nie sa -zainstalowane w systemie, nalezy zadbac aby nie bylo tez pliku -ot4cmr.fd na sciezce LaTeXa, aby nie wprowadzic w blad procedury -rozpoznajacej srodowisko w stylu polski.sty. Na zakonczenie nalezy -skopiowac pliki *.fd *.sty *.def *.cfg oraz plhyph.tex do katalogu -czytanego przez TeXa podczas kompilacji. - -Ostatnim etapem jest wygenerowanie nowego formatu LaTeXa. Jest to -potrzebne dla umieszczenia w formacie polskich wzorcow przenoszenia. -Sposob generowania formatu zalezy od implementacji. W wiekszosci -wspolczesnych implementacji trzeba wywolac program tex ze specjalna -opcja na pliku latex.ltx. W teTeXu, web2c, TeXlive jest to - tex -ini latex.ltx -w emTeXu - tex386 /i/o/r /mt13000 latex.ltx - -Uwaga: wygenerowanie formatu przy pomocy plikow konfiguracyjnych -zawartych w PLaTeXu powiedzie sie tylko jezeli LaTeX znajdzie pliki -hyphen.cfg i language.dat _przed_ analogicznymi plikami z pakietu -Babel, ktore moga jednoczesnie byc obecne w systemie. Mozna to -osiagnac manipulujac zmiennymi w srodowisku (stosownie do -implementacji) lub umieszczajac hyphen.cfg i language.dat w biezacym -katalogu. -Uwaga 2: wspolczesne implementacje czesto zawieraja pomocnicze -narzedzia automatyzujace generowanie formatow. +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 +przenoszenia. +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 -Pliki dtx zawieraja teksty makr wraz z dokumentacja. Sa one gotowe -do wydruku po przepuszczeniu przez LaTeX. Instrukcje poslugiwania sie -stylem polski mozna uzyskac uruchamiajac +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 uzywajac swojego ulubionego podgladacza. +a dalej używając swojego ulubionego programu do podglądu. --- Osmiobitowe wprowadzanie polskich liter -Niezawodnym sposobem wprowadzania polskich znakow jest skorzystanie z -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. +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: -W implementacjach, które nie dają takiego wsparcia, można zastosować -podejście przez znaki aktywne implementowane w standardowym pakiecie -inputenc. +* 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. 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 zewnetrznymi. 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 (włącznie ze znakami nieliterowymi). +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 +zakodowane w Unikodzie zapisanym w formie UTF-8 (opcja utf8). Oto szczegóły specyficzne dla implementacji: ------ web2c, teTeX, TeXlive, fpTeX, mikTeX -W tych implementacjach kodowanie dokumentu zadaje się przy pomocy -opcji --translate-file zadają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 przy pomocy następującego ,,magicznego'' komentarza: + +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'' +komentarza: %&latex --translate-file=il2-pl @@ -177,7 +175,8 @@ komentarza w pierwszych liniach pliku. W przypadku pracy z emTeXem przekodowanie musi zostać ,,zaszyte'' w plik formatu. Jeżeli ma się do czynienia z dokumentami w różnych -układach, konieczny jest oddzielny plik formatu dla każdego układu. +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 @@ -195,10 +194,11 @@ kodow \documentclass{article} \usepackage{polski} \usepackage[mazovia]{inputenc} -Podczas instalacji PLaTeXa tworzone sa pliki ze stronami kodowymi: + +Podczas instalacji pakietu Polski tworzone sa pliki ze stronami kodowymi: mazovia - dla popularnej (kiedyś) strony kodowej na PCetach. -amigapl - dla polskiej strony kodowej uzywanej na Amidze +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: @@ -206,19 +206,20 @@ interesuj 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) -Wiekszosc instalacji TeXowych czyta osmiobitowe znaki zawarte w -dokumentach. Niektore starsze implementacje wymagaja uzycia do tego -specjalnej opcji podczas generowania formatu. W przypadku emTeXa jest -to opcja /8, format nalezy wygenerowac komenda - tex386 /i /8 /mt13000 latex.ltx -Parametr /mt zwieksza wewnetrzne tablice emTeXa tak by zmiescily sie -dwa komplety wzorcow przenoszenia, amerykanski i polski. +Większość instalacji TeXowych czyta osmiobitowe znaki zawarte w +dokumentach. Niektóre starsze implementacje wymagają użycia do tego +specjalnej opcji podczas generowania formatu. ---- Podziekowania +--- Podziękowania -* Markowi i Jackowi za MeXa i LaMeXa -* Robert Ramiega przyslal tablice kodowa uzywana na Amidze +* 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 -- cgit v1.2.3