summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/platex/base/czytaj.txt
blob: 15c535043926a42f10535237a3443154f17e56d9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
**********************************************************************
*                                                                    *
*                   PLaTeX 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.                *
*                                                                    *
**********************************************************************


--- Informacje ogolne

Pakiet PLaTeX dostarcza narzedzi potrzebnych do skladu dokumentow
w jezyku polskim LaTeXem 2e.  Glowne 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
  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
  notacji prefiksowej z dowolnie wybranym prefiksem (pomocny
  np. do robienia wydrukow z CWEBa).
* styl OT1patch dorabia ogonki wg najlepszych znanych standardow do
  oryginalnych czcionek CM (kod Leszka Holenderskiego).

Nie zachecamy do stosowania tych pakietow, poza szczegolnymi
przypadkami.

  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.

--- Licencja

PLaTeX 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

W sklad pakietu wchodzi kilka plikow zawierajacych udokumentowane 
(w wiekszosci :-) zrodla makr.

* polski.dtx - zawiera zrodla pakietu polski
* strony.dtx - plik z wejsciowymi stronami kodowymi dla LaTeXa oraz
  definicja ukladu 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.ins - skrypt instalacyjny dla plprefix.sty
* ot1patch.dtx - zawiera zrodla stylu dorabiajacego ogonki
  do czcionek CM
* ot1patch.ins - skrypt instalacyjny dla ot1patch.sty
* czytaj.txt - ten plik
* readme.txt - opis instalacji po angielsku
* conowego.txt - lista zmian w pakiecie

--- 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.

--- 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
    latex polski.dtx
a dalej uzywajac swojego ulubionego podgladacza.


--- 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.

W implementacjach, które nie daj± takiego wsparcia, mo¿na zastosowaæ
podej¶cie przez znaki aktywne implementowane w standardowym pakiecie
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).

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 
	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:

%&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
uk³adach, konieczny jest oddzielny plik formatu dla ka¿dego uk³adu. 

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 PLaTeXa tworzone sa pliki ze stronami kodowymi:

mazovia     - dla popularnej (kiedy¶) strony kodowej na PCetach.
amigapl     - dla polskiej strony kodowej uzywanej 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)

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.

--- Podziekowania

* Markowi i Jackowi za MeXa i LaMeXa
* Robert Ramiega przyslal tablice kodowa uzywana na Amidze




**********************************************************************
 Marcin Woli\'nski                         mailto:wolinski@gust.org.pl
                                     http://www.mimuw.edu.pl/~wolinski
**********************************************************************