summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/polski/czytaj.txt
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/polski/czytaj.txt
Initial commit
Diffstat (limited to 'macros/latex/contrib/polski/czytaj.txt')
-rw-r--r--macros/latex/contrib/polski/czytaj.txt230
1 files changed, 230 insertions, 0 deletions
diff --git a/macros/latex/contrib/polski/czytaj.txt b/macros/latex/contrib/polski/czytaj.txt
new file mode 100644
index 0000000000..e04af5148c
--- /dev/null
+++ b/macros/latex/contrib/polski/czytaj.txt
@@ -0,0 +1,230 @@
+**********************************************************************
+* *
+* 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,2007 by Marcin Woli\'nski. *
+* *
+**********************************************************************
+
+
+--- Informacje ogólne
+
+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)
+
+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).
+* 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.
+
+ 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.
+
+--- Licencja
+
+'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
+
+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
+ 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 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 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.
+
+
+--- 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ą
+dwa sposoby:
+
+* 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 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ę 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''
+komentarza:
+
+%&latex --translate-file=il2-pl
+
+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
+komentarza w pierwszych liniach pliku.
+
+------ 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.
+
+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
+
+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
+
+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)
+
+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
+
+* 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
+**********************************************************************