summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/polski/czytaj.txt
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2007-12-23 01:10:35 +0000
committerKarl Berry <karl@freefriends.org>2007-12-23 01:10:35 +0000
commite5fe07f6ccccd3508620e2159b9a6367100c50ea (patch)
tree19d9201d78852739ecb769c68968e1c7b0912d6d /Master/texmf-dist/doc/latex/polski/czytaj.txt
parent2154eaa8df555b17f72558d748c04bfe1c9c144b (diff)
polski 1.3.2 update (22dec07)
git-svn-id: svn://tug.org/texlive/trunk@5828 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/polski/czytaj.txt')
-rw-r--r--Master/texmf-dist/doc/latex/polski/czytaj.txt237
1 files changed, 119 insertions, 118 deletions
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ą, np.
\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ą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)
-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