diff options
| author | Karl Berry <karl@freefriends.org> | 2006-01-09 00:44:40 +0000 |
|---|---|---|
| committer | Karl Berry <karl@freefriends.org> | 2006-01-09 00:44:40 +0000 |
| commit | b4fc5f639874db951177ec539299d20908adb654 (patch) | |
| tree | 52f08823ca58fffe3db6a9b075635038c567626c /Master/texmf-dist/doc/latex/platex | |
| parent | dec3d98ebe442d7ea93efbaa8dd2e2be8149a467 (diff) | |
doc 4
git-svn-id: svn://tug.org/texlive/trunk@80 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/platex')
| -rw-r--r-- | Master/texmf-dist/doc/latex/platex/base/00readme | 307 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/platex/base/conowego.txt | 94 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/platex/base/czytaj.txt | 229 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/platex/base/platex.html | 316 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/platex/base/r22.mps | 78 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/platex/base/readme.txt | 26 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/platex/base/tstlatex.tex | 117 |
7 files changed, 1167 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/platex/base/00readme b/Master/texmf-dist/doc/latex/platex/base/00readme new file mode 100644 index 00000000000..3ac6e0794fd --- /dev/null +++ b/Master/texmf-dist/doc/latex/platex/base/00readme @@ -0,0 +1,307 @@ +%% Staszek Wawrykiewicz (StaW@gust.org.pl), January 2003. Public domain. +%% Web2c (teTeX, fpTeX, TeX Live) and MiKTeX 2.x revision +PLaTeX and pdfPLaTeX + +Dokumentacja po polsku i po angielsku (nizej). +The documentation in Polish and in English (below). + +------------------------------------------------------------------------ +POLSKI (iso8859-2): +------------------------------------------------------------------------ + +Dokumentacja niniejsza omawia pokrótce tworzenie formatów dla programów tex +i pdftex (wersji TeX-a tworzącej od razu pliki PDF) ze wsparciem dla języka +polskiego i ich użycie w środowisku opartym na web2c (dystrybucje TeX +Live/teTeX/fpTeX) lub MiKTeX. + +Poniżej pokazano prosty przykład tworzenia pliku z użyciem pakietu PLaTeX. +Pakiet ten dostarcza narzędzi potrzebnych do składu dokumentów w języku +polskim LaTeXem 2e. +Autorzy pakietu: Mariusz Olko i Marcin Woliński. +Więcej informacji na temat samego pakietu -- patrz plik czytaj.txt +dystrybucji PLaTeX. + +Ponadto w dystrybucjach dołączono przykładowy plik +doc/latex/platex/tstlatex.tex. służący do przetestowania poprawnego +działania formatu LaTeX/PLaTeX. Początkującym użytkownikom zaleca się +zapoznanie z zawartością tego pliku. Plik ten dostępny jest także na +serwerze GUST. Techniczne szczegóły dotyczące użycia pakietu polski.sty +(główny element pakietu platex) dostępne są po dwukrotnym uruchomieniu: +platex polski.dtx +platex polski.dtx +i wyświetleniu wynikowego polski.dvi. + +--------------------------------------------------------------------------- + +I. Przygotowanie formatu LaTeX2e do obsługi języka polskiego + +Format w systemie TeX to wstępnie prekompilowany (aby przyspieszyć jego +analizę przez program tex/pdftex) zestaw makrodefinicji oraz reguł +przenoszenia wyrazów dla wybranego zestawu języków. Plik formatu z reguły +posiada rozszerzenie .fmt. Tworzenie formatu to, w skrócie, uruchomienie +programu tex/pdftex z opcją --ini i wczytanie odpowiedniego pliku +inicjującego (dla LateX jest to plik latex.ltx). W LaTeX 2e zestaw reguł +przenoszenia wyrazów jest zwyczajowo deklarowany w pliku o nazwie +language.dat. Plik ten znajduje się zwykle w podkatalogu +tex/generic/config/language.dat lokalnej konfiguracji systemu TeX bądź +w identycznym podkatalogu katalogu głównego instalacji. Modyfikacja +language.dat polega na usunięciu w tym pliku znaku komentarza `%' w wierszu +polish plhyph.tex +i ewentualnym zablokowaniu takim znakiem niepożądanych deklaracji wzorców +dzielenia wyrazów. Przygotowanie formatu: + + * standardowe: w teTeX należy uruchomić program texconfig, uaktywnić + reguły dzielenia wyrazów dla języka polskiego (menu Hyphenation + uruchamia edycję pliku language.dat; po zapisaniu zmian w pliku + i zakończeniu edycji, zostanie automatyczne wygenerowany format + latex.fmt zawierający wybrane wzorce dzielenia oraz mechanizm Babel + przełączania języków; texconfig tworzy ponadto dowiązanie (lub + program) latex. + Dla dociekliwych: powyższe odpowiada uruchomieniu z linii poleceń: + fmtutil --byfmt latex + zaś na niższym poziomie -- poleceniu + tex --ini --progname=latex latex.ini + W instalacji MiKTeX (od wersji 2.0) należy uruchomić menu MiKTeX + Options, zaznaczyć w podmenu Languages: polish reguły przenoszenia + wyrazów, po czym w menu TeX Formats wygenerować (przyciskiem Build) + nowy format latex.fmt, zawierający polskie wzorce. + Format pdflatex.fmt dla programu pdftex tworzony jest analogicznie. + + * niestandardowe, które tworzy ,,czysty'' format LaTeX2e zawierający + jedynie wybrane wzorce dzielenia wyrazów, bez zbędnych mechanizmów + Babel. Jest to metoda preferowana przez wielu polskich użytkownikow. + ;-) Dlaczego PLaTeX a nie Babel? O tym poniżej. Dla odróżnienia + przyjęto nazywać taki format platex (lub pdfplatex dla pdfTeX). + Formaty te korzystają z ,,prywatnej'' kopii pliku language.dat + z zadeklarowanymi od razu polskimi i angloamerykanskimi wzorcami + przenoszenia wyrazów. Procedura opisana w poprzednim punkcie pozwala + na wygenerowanie takich formatów za pomocą programu texconfig: menu + Formats uruchamia edycję pliku fmtutil.cnf, należy tu odblokować + wiersz dotyczący formatu platex lub pdfplatex (usunąć znak # przed + deklaracją interesującego nas formatu) i , po zapisaniu pliku, + powrócić do menu nadrzędnego; ,,w tle'' zostanie wykonany program + fmtutil; utworzone zostanie ponadto dowiązanie platex (pdfplatex). + W wypadku gdy nie mamy (jeszcze) programu texconfig (fpTeX dla + Windows) procedura generowania formatu platex (lub pdfplatex) da się + przedstawić następująco: + 1. należy odszukać plik texmf/web2c/fmtutil.cnf (edytujemy kopię + tego pliku znajdującą sią w lokalnym drzewie katalogów TeX-owych + użytkownika lub w drzewie przeznaczonym na lokalne konfiguracje; + położenie właściwego pliku pokaże uruchomienie polecenia + kpsewhich fmtutil.cnf); + 2. w pliku fmtutil.cnf należy odblokować wiersz dotyczący formatu + platex lub pdfplatex (usunąć znak #); + 3. uruchomić polecenie: fmtutil --byfmt platex --dolinks (lub + fmtutil --byfmt pdfplatex --dolinks). + Dla MiKTeX (od wersji 2.0) należy uruchomić menu MiKTeX Options, + w podmenu TeX Formats zaznaczyć format PLaTeX (lub pdfPLaTeX) + i utworzyć (przyciskiem Build) potrzebne formaty. + + W omawianych wyżej przypadkach tworzony jest plik formatu platex.fmt + (lub pdfplatex.fmt), który jest umieszczany w katalogu właściwym dla + tego rodzaju plików, oraz tworzony jest program platex lub pdfplatex + (uruchamia on program tex lub pdftex z odpowiednim formatem). + +Dlaczego PLaTeX a nie Babel? + +(Fragment ten jest cytatem z listu nadesłanego na listę dyskusyjną GUST +przez Marcina Wolińskiego). +W porównaniu do pakietu Babel, PLaTeX ma kilka mniej lub bardziej istotnych +zalet: + + * PLaTeX udostępnia tradycyjne definicje nazw polskich funkcji + trygonometrycznych \tg, \ctg, \arc i polskich znaków mniejsze-równe + oraz większe-równe. + * PLaTeX umie poprawne przenosić wyrazy złożone (tj. takie jak np. + biało-czerwony) udostępniając do tego celu polecenie \dywiz. + * PLaTeX wstawia prawidłowe odstępy na końcu zdania. + * Babel nie wspiera do końca fontów w układzie OT4 (fontów PL), co + powoduje, że polskie znaki diakrytyczne w wyrazach wstawianych + automatycznie przez LaTeX (dokładnie ,,ę'' w słowie część oraz ,,ą'' + w słowie ,,załącznik'') sklejane z dwóch znaków. Jest to drobny, ale + ciągle nie usunięty błąd. (Można go poprawić samodzielnie dokonując + niewielkiej modyfikacji pliku polish.sty z dystrybucji pakietu Babel.) + Obwiedniowe fonty OT4 są niezastąpione przy tworzeniu plików + w formacie PDF. + +Podsumowując: jeżeli nie potrzebujemy środowiska wielojęzycznego to dużo +mniejsza objętość pakietu PLaTeX oznacza także mniejszą liczbę błędów +i potencjalnych kolizji z innymi częściami LaTeXa. +[achiwum GUST-L, list z 06/06/1997] +--------------------------------------------------------------------------- + +II. Użycie + +Aktualne implementacje, oparte na Web2c, a także MiKTeX pozwalają na +prawidłowe przekodowanie znaków diakrytycznych w pliku TeX-owym na +wewnętrzną reprezentację, stosowaną przez programy. W Polsce, niestety, +stosowane są różne ,,standardy'' kodowania diakrytyków w tworzonych przez +użytkownika plikach, zależnie od systemu operacyjnego. Dla potrzeb systemu +TeX używamy zewnętrznych, tekstowych plików TCX, pozwalających ,,obsłużyć'' +różne spotykane ,,standardy''. Dzięki temu przekodowanie działa też w drugą +stronę, kiedy TeX wyświetla komunikaty i zapisuje pliki .log, a także pliki +ze spisem treści, skorowidzem itp. + +Uruchomienie polecenia: +latex --translate-file=TCXFILE myfile.tex +oznacza uruchomienia TeX-a z formatem latex.fmt i z odpowiednią tablicą +przekodowań (ich lista znajduje się poniżej). W identyczny sposób +uruchamiamy polecenie platex. + +Przekodowanie (plik TCX) może być deklarowane bezpośrednio w pliku +TeX-owym. Począwszy od wersji Web2c 7.4, wymaga to podania w wierszu +poleceń opcji --parse lub włączenia jej na stałe, co wymaga zmiany +w głównym pliku konfiguracyjnym texmf.cnf: +parse_first_line = t +(t -- od `true', zamiast domyślnego przypisania f -- od `false'). + +Przykładowo, jeśli pierwszy wiersz pliku zawiera komentarz strukturalny +postaci +%&platex --translate-file=il2-pl +to plik może być przetworzony za pomocą polecenia tex plik.tex; zostanie +wtedy wczytany format platex.fmt oraz tablica il2-pl.tcx przekodowania +z układu iso8859-2 (latin2) do układu fontów PL (wewnętrznego dla programu +TeX; w LaTeX-u ma on kryptonim OT4). + +Tym samym zbędne są deklaracje w preambule pliku LaTeX-owego: +\usepackage[latin2]{inputenc} +\usepackage[OT4]{fontenc} + +W dystrybucjach dostarczono szereg plikow TCX. Można je znaleźć w katalogu +texmf/web2c/: + amiga-pl.tcx AmigaPL do PL + il2-pl.tcx iso8859-2 (latin2) do PL + cp1250pl.tcx Windows cp1250 do PL + cp852-pl.tcx IBM cp852 do PL + macce-pl.tcx Apple MacCE do PL + maz-pl.tcx Mazovia do PL + +A oto przykład pliku LaTeX-owego: + + %& --translate-file=cp1250pl + \documentclass[a4paper]{article} + \usepackage{polski} + \begin{document} + Polskie literki piszemy w standardzie Windows cp1250: ..... + \end{document} + +Jak widać, nasz plik ma krótką preambułę -- pakiet polski korzysta +domyślnie z zainstalowanych fontów PL (odpowiada mu układ OT4, więc zbędna +jest deklaracja \usepackage[OT4]{fontenc}). Jeśli korzystamy +z fontów EC nasza preambuła powinna zawierać dodatkowy wiersz: +\usepackage[T1]{fontenc} + +III. Polskie fonty PostScriptowe + +Aktualne dystrybucje zawierają fonty serii PL (spolonizowane standardowe +dla TeX-a fonty CM) w wersji Type 1 (postscriptowe). Można je także znaleźć +w najbliższym węźle CTAN lub jego kopii, np.: +ftp://sunsite.icm.edu.pl/CTAN/fonts/psfonts/polish/plpsfont/. +Pliki .pfb powinny znaleźć się w podkatalogu texmf/fonts/type1/public/pl/ +naszej instalacji, zaś pliki map fontowych (.map) oraz wektory kodowań +(.enc) -- w katalogu texmf/dvips/pl/ + +W dystrybucjach opartych na Web2c zautomatyzowano, poprzez użycie programu +updmap, proces tworzenia map fontowych dla programów dvips, pdftex +i dvipdfm. Poniżej omówiono więc jedynie czego ten proces dotyczy. + +Sterownik dvips (zamieniający wynik pracy TeX-a, plik DVI, do formatu +PostScript) wymaga aby deklaracje map fontowych (dla fontów PL konkretnie +zawartość texmf/dvips/pl/pl.map) były dołączone do pliku +texmf/dvips/config/psfonts.map. Mapy fontowe można alternatywnie dołączyć +w pliku texmf/dvips/config/config.ps (lub jego lokalnej kopii), dopisując +wiersz: +p +pl.map +po deklaracji głównej mapy fontowej: p psfonts.map. + +Aby fonty Type 1 były użyte przez program pdfTeX, należy sprawdzić jakie +mapy fontowe są deklarowane w pliku texmf/dvips/config/pdftex.map -- +powinien on także zawierać deklaracje map fontowych dla fontów PL. + +W dystrybucjach wszystkie aktualnie dostępne polskie fonty Type1 są gotowe +do użycia zarówno przez program dvips, jak i pdftex. + +Bardziej szczegółowe omówienie instalacji fontów Type1 zawarte jest +w artykule Instalowanie fontów Type1/True Type. + +------------------------------------------------------------------------ +ENGLISH: +------------------------------------------------------------------------ + +PLaTeX provides tools to typeset documents in Polish using LaTeX2e. +Authors: Mariusz Olko & Marcin Woli\'nski. +This document describes shortly creation of latex.fmt (or platex.fmt) +for Polish and usage in MiKTeX environement. +See readme.txt for more informations about the PLaTeX package. + +I. Preparing LaTeX2e format for Polish + There are two methods: + 1. `standard': just activate polish hyphenation patterns in the file + language.dat (menu `Hyphenation' in teTeX's texconfig or `Languages' + in `MiKTeX Options') and recompile latex.ltx (for MiKTeX 2.x from the + menu `TeX Formats'); as a result, latex.fmt including Babel machinery + will be generated. + 2. `non standard': it produces a clean and generic LaTeX2e without Babel + deadwood, containing only patterns for Polish and US English; this + method is prefered by many users in Poland. ;-) + The distribution allows to generate such a format: platex.fmt + (or pdfplatex.fmt) from teTeX's texconfig `Formats' menu (for MiKTeX + `TeX Formats' menu). + +II. Usage: the current implementations based on web2c, and MiKTeX + allow (hopefully) proper reencoding of input national characters + into internal TeX's, and back again, for all messages, .log, .toc, + .idx files written by TeX, etc. External readable TCX translation + files are used and they can be specified explicitly in the TeX file + or in the command line. + If we use latex.fmt with Polish patterns we can compile our file + with the command `latex --translate-file=TCXFILE myfile.tex'. + If the parse_fist_line is enabled (`--parse' option in the command line + or, permanently, parse_fist_line=t in texmf.cnf) + and the *first* line of TeX's file contains a structured comment + of the form + %&platex --translate-file=il2-pl + it suffices to run `tex file.tex' with platex.fmt and il2-pl.tcx + translation table (iso8859-2 to internal PL reencoding, which in fact + is recognized as LaTeX's OT4). + You can use TCX tables instead of LaTeX's + \usepackage[latin2]{inputenc} + \usepackage[OT4]{fontenc} + We can make a `platex' command available making on Unix a soft link + to tex, or (Windows) making a copy tex.exe into platex.exe in the + directory containing binaries. + Thus `platex -translate-file=TCXFILE myfile.tex' can be used as well. + Several TCX files are provided; they can be found in the .../web2c/ + directory: + amiga-pl.tcx AmigaPL <--> PL encoding + il2-pl.tcx iso8859-2 (latin2) <--> PL encoding + cp1250pl.tcx Windows cp1250 <--> PL encoding + cp852-pl.tcx IBM cp852 <--> PL encoding + macce-pl.tcx Apple MacCE <--> PL + maz-pl.tcx Mazovia <--> PL encoding + +III. Polish PostScript fonts in Type 1 format + The installation can already contain Type 1 PL fonts; + they can be also downloaded from the nearest CTAN node or its mirror: + CTAN//fonts/psfonts/polish/plpsfont/ + or copied from the CD TeX Live. + .pfb files should reside in the directory: .../fonts/type1/public/pl/ ; + font map and encoding files should go to .../dvips/pl/ directory. + + The preparation of map files are now automatized by running updmap + program. + + Dvips can be prepared for using PL fonts in Type 1 format in two ways: + * the contents of texmf/dvips/pl/pl.map should be included + into the standard texmf/dvips/config/psfonts.map. + * in texmf/dvips/config/config.ps the additional map file can be + declared after standard `p psfonts.map' line: + p +pl.map + + In order to use Type 1 fonts with pdfTeX, the contents of + texmf/dvips/config/pdftex.map file can be updated with + the contents of pl.map, or the line + map +pl.map + can be added to the file texmf/pdftex/config/pdftex.cfg. + +--------------------------------------------------------------------------- diff --git a/Master/texmf-dist/doc/latex/platex/base/conowego.txt b/Master/texmf-dist/doc/latex/platex/base/conowego.txt new file mode 100644 index 00000000000..aa4621095f2 --- /dev/null +++ b/Master/texmf-dist/doc/latex/platex/base/conowego.txt @@ -0,0 +1,94 @@ +Zmiany w pakiecie PLaTeX +======================== + +Wersja 1.3.1 (2003/05/09): +========================== + +* Niekompatybilna zmiana makra \today: już nie ma ' roku' na końcu. + Poprzednie zachowanie można uzyskać za pomocą opcji pakietu 'roku'. + Opcja 'r.' daje wariant '9 maja 2003 r.'. + +Wersja 1.3.0 (2003/03/19): +========================== + +* Z tajemniczych powodów cotangens nazywał się \ctan zamiast \cot. + Poprawione. +* Dodana funkcja \nwd jako tłumaczenie \gcd. +* Dodana opcja QX (analogiczna do OT4 i T1). +* Polecenia \mathit, \mathbf, ... będą działać poprawnie z polskimi + znakami, o ile użyte z TCX. +* Nowe opcje prefixinginverb i noprefixinginverb. + +Wersja 1.2.4: +============= + +* Poprawiony błąd w trybie \prefixing: /l i /L zżerało odstępy w + spisie treści (zgłosił Bogusław Jackowski, dzięki!) + +Wersja 1.2.3: +============= + +* Poprawiony błąd w trybie \prefixing: // powodowało błędy w spisie treści +* Nowa wersja układu QX zawiera znak Euro + +Wersja 1.2.2: +============= + +* Poprawiony błąd w opcji MeX związany z makrem \= + +Wersja 1.2.1: +============= + +* dodany plik qxenc.def definiujacy układ fontow QX +* drobne zmiany dokumentacji +* wylaczono tworzenie pliku ot4enc.def, poniewaz jest on juz w + dystrybucji LaTeXa (dla starszych dystrybucji wystarczy usunac + komentarz w oznaczonym miejscu pliku platex.ins) + +Wersja 1.2: +============ + +* rozpowszechniana na zasadach LaTeX Project Public License +* zmienione wszystkie pliki .fd odwzorowujace LaTeXowe nazwy krojow + pisma w nazwy plikow metrycznych. Nowe definicje pozwalaja na + zaladowanie fontow PL w dowolnym stopniu pisma. Pliki sa zgodne ze + starymi w tym sensie, ze wszystkie uprzednio dostepne kombinacje + kroj/grubosc/odmiana/stopien powoduja zaladowanie tego samego fontu, + co poprzednio +* nowe polecenia \pauza i \ppauza generujace pauze i polpauze z + dwupunktowymi odstepami +* zmienione makro \seename (uzywane przez makeidx.sty w pozycjach + odsylaczowych skorowidza) (bylo ,,Patrz'', jest ,,zob.'') +* zmienione \refname na ,,Literatura'' i \bibname na ,,Bibliografia'' +* drobne poprawki: bardziej robustna procedura hyphen.cfg + + +Wersja 1.01: +============ + +* nowe polecenie \selecthyphenation umozliwiajace zmiane uzywanych + wzorcow dzielenia wyrazow (krotkie wstawki w obcych jezykach) +* poprawione w formacie bledne wartosci \*hyphenmin dla angielskiego + + +Wersja 1.0: +============ + +* zmiana nazwy --- dawniej ,,Po polsku'' +* nowy sposob generowania formatu, konfiguracja przy pomocy pliku + language.dat +* dokumenty uzywajace pakietu beda sie poprawnie skladac przy pomocy + formatu wygenerowanego przez Babel +* format wygenerowany przy pomocy hyphen.cfg z PLaTeXa pozwala na + poprawny sklad dokumentow uzywajacych pakietu babel +* zostala ulepszona zgodnosc PLaTeXa z MeXem/LaMeXem +* dostosowano nazwy plikow do zmienionego standardu LaTeXa --- + wszystkie nazwy sa pisane wylacznie minuskulami +* wyeliminowano pewna ilosc bledow (np. blad w pierwszej formule w + dokumentach skladanych z uzyciem fontow PL; w trybie zgodnosci z + MeXem problem z uzyciem \= w przypisach) +* deklaracja \prefixing jest teraz lokalna +* dodano dwa pakiety (plprefix i ot1patch) wspomagajace sklad w + trudnych warunkach (tj. gdy standardowy sposob instalacji PLaTeXa z + jakichs powodow jest nieodpowiedni) + diff --git a/Master/texmf-dist/doc/latex/platex/base/czytaj.txt b/Master/texmf-dist/doc/latex/platex/base/czytaj.txt new file mode 100644 index 00000000000..15c53504392 --- /dev/null +++ b/Master/texmf-dist/doc/latex/platex/base/czytaj.txt @@ -0,0 +1,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 +********************************************************************** diff --git a/Master/texmf-dist/doc/latex/platex/base/platex.html b/Master/texmf-dist/doc/latex/platex/base/platex.html new file mode 100644 index 00000000000..ed8482ea347 --- /dev/null +++ b/Master/texmf-dist/doc/latex/platex/base/platex.html @@ -0,0 +1,316 @@ +<HTML> +<HEAD> +<meta http-equiv="content-type" content="text/html; charset=iso-8859-2"> +<TITLE>PLaTeX, pdfPLaTeX</TITLE> +</HEAD> + +<BODY> + +<!-- January 2003. Staszek Wawrykiewicz (StaW@gust.org.pl). +teTeX 2.0 revision. Public domain. --> + +<center> +<h2>PLaTeX i pdfPLaTeX</h2> +</center> + +Dokumentacja niniejsza omawia pokrótce tworzenie formatów dla programów +<code>tex</code> i <code>pdftex</code> (wersji TeX-a tworzącej od razu +pliki PDF) ze wsparciem dla języka polskiego i ich użycie +w środowisku opartym na <code>web2c</code> (dystrybucje +TeX Live/teTeX/fpTeX) lub MiKTeX. <p> + +<p> +Poniżej pokazano prosty przykład tworzenia pliku z użyciem +pakietu PLaTeX. Pakiet ten dostarcza narzędzi potrzebnych do składu +dokumentów w języku polskim LaTeXem 2e.<br> +Autorzy pakietu: Mariusz Olko i Marcin Woliński.<br> +Więcej informacji na temat samego pakietu -- patrz plik +<code>czytaj.txt</code> dystrybucji PLaTeX. + +<p> +Ponadto w dystrybucjach +dołączono przykładowy plik <code>doc/latex/platex/tstlatex.tex</code>. +służący do przetestowania poprawnego +działania formatu LaTeX/PLaTeX. Początkującym użytkownikom zaleca się +zapoznanie z zawartością tego pliku. +Plik ten dostępny jest także na serwerze +<a href="ftp://ftp.gust.org.pl/pub/TeX/GUST/contrib/zaczynam/">GUST</a>. +Techniczne szczegóły dotyczące użycia pakietu polski.sty +(główny element pakietu platex) dostępne są po dwukrotnym uruchomieniu:<br> + <code>platex polski.dtx</code><br> + <code>platex polski.dtx</code><br> +i wyświetleniu wynikowego <code>polski.dvi</code>.<p> + +<hr> + +<h3>I. Przygotowanie formatu LaTeX2e do obsługi języka polskiego</h3> + +Format w systemie TeX to wstępnie prekompilowany (aby przyspieszyć +jego analizę przez program <code>tex/pdftex</code>) zestaw makrodefinicji oraz reguł +przenoszenia wyrazów dla wybranego zestawu języków. +Plik formatu z reguły posiada rozszerzenie <code>.fmt</code>. +Tworzenie formatu to, w skrócie, uruchomienie programu +<code>tex/pdftex</code> +z opcją <code>--ini</code> i wczytanie odpowiedniego pliku +inicjującego (dla LateX jest to plik <code>latex.ltx</code>). +W LaTeX 2e zestaw reguł przenoszenia wyrazów jest zwyczajowo +deklarowany w pliku o nazwie <code>language.dat</code>. +Plik ten znajduje się zwykle w podkatalogu +<code>tex/generic/config/language.dat</code> lokalnej konfiguracji systemu +TeX bądź w identycznym podkatalogu katalogu głównego instalacji. Modyfikacja +<code>language.dat</code> polega na usunięciu w tym pliku znaku komentarza +`%' w wierszu<br> +<code>polish plhyph.tex</code><br> +i ewentualnym +zablokowaniu takim znakiem niepożądanych deklaracji wzorców dzielenia wyrazów. + +Przygotowanie formatu: +<ul> + <li> <b>standardowe</b>: w teTeX należy uruchomić program <code>texconfig</code>, + uaktywnić reguły dzielenia wyrazów dla języka polskiego (menu + <code>Hyphenation</code> uruchamia edycję pliku + <code>language.dat</code>; po zapisaniu zmian w pliku + i zakończeniu edycji, zostanie automatyczne wygenerowany format + <code>latex.fmt</code> zawierający + wybrane wzorce dzielenia oraz mechanizm Babel przełączania języków; + <code>texconfig</code> tworzy ponadto dowiązanie (lub program) + <code>latex</code>.<br> + Dla dociekliwych: powyższe odpowiada uruchomieniu z linii + poleceń:<br> + <code>fmtutil --byfmt latex</code><br> + zaś na niższym poziomie -- poleceniu<br> + <code>tex --ini --progname=latex latex.ini</code><br> + W instalacji MiKTeX (od wersji 2.0) należy uruchomić menu + <code>MiKTeX Options</code>, zaznaczyć w podmenu + <code>Languages: polish</code> reguły przenoszenia wyrazów, po czym + w menu <code>TeX Formats</code> wygenerować (przyciskiem + <code>Build</code>) nowy format <code>latex.fmt</code>, zawierający + polskie wzorce.<br> + Format <code>pdflatex.fmt</code> dla programu <code>pdftex</code> + tworzony jest analogicznie. +<li> <b>niestandardowe</b>, które tworzy ,,czysty'' format LaTeX2e zawierający + jedynie wybrane wzorce dzielenia wyrazów, bez zbędnych mechanizmów Babel. + Jest to metoda preferowana przez wielu polskich użytkownikow. ;-) + <a href=#AA1>Dlaczego PLaTeX a nie Babel?</a> O tym poniżej. + Dla odróżnienia przyjęto nazywać taki format <code>platex</code> + (lub <code>pdfplatex</code> dla pdfTeX). Formaty te korzystają z ,,prywatnej'' + kopii pliku <code>language.dat</code> z zadeklarowanymi od razu + polskimi i angloamerykanskimi wzorcami przenoszenia wyrazów. + Procedura opisana + w poprzednim punkcie pozwala na wygenerowanie takich formatów + za pomocą programu <code>texconfig</code>: menu + <code>Formats</code> + uruchamia edycję pliku <code>fmtutil.cnf</code>, należy tu + odblokować wiersz dotyczący formatu <code>platex</code> lub + <code>pdfplatex</code> (usunąć znak # przed deklaracją interesującego nas + formatu) i , po zapisaniu pliku, powrócić do menu nadrzędnego; + ,,w tle'' zostanie wykonany program <code>fmtutil</code>; + utworzone zostanie ponadto dowiązanie + <code>platex</code> (<code>pdfplatex</code>).<br> + W wypadku gdy nie mamy (jeszcze) programu <code>texconfig</code> (fpTeX dla + Windows) procedura generowania formatu <code>platex</code> (lub + <code>pdfplatex</code>) da się przedstawić następująco:<br> +<ol> +<li>należy odszukać plik <code>texmf/web2c/fmtutil.cnf</code> (edytujemy + kopię tego pliku + znajdującą sią w lokalnym drzewie katalogów TeX-owych użytkownika + lub w drzewie przeznaczonym na lokalne konfiguracje; położenie + właściwego pliku pokaże uruchomienie polecenia + <code>kpsewhich fmtutil.cnf</code>); +<li> w pliku fmtutil.cnf należy odblokować wiersz dotyczący formatu + <code>platex</code> lub <code>pdfplatex</code> (usunąć znak #); +<li> uruchomić polecenie: <code>fmtutil --byfmt platex --dolinks</code> (lub + <code>fmtutil --byfmt pdfplatex --dolinks</code>). +</ol> + + Dla MiKTeX (od wersji 2.0) + należy uruchomić menu <code>MiKTeX Options</code>, w podmenu + <code>TeX Formats</code> zaznaczyć format + <code>PLaTeX</code> (lub <code>pdfPLaTeX</code>) i utworzyć + (przyciskiem <code>Build</code>) potrzebne formaty. + +<p> +W omawianych wyżej przypadkach tworzony jest plik formatu + <code>platex.fmt</code> (lub <code>pdfplatex.fmt</code>), który jest + umieszczany w katalogu właściwym dla tego rodzaju + plików, oraz tworzony jest program <code>platex</code> lub + <code>pdfplatex</code> (uruchamia on program <code>tex</code> lub + <code>pdftex</code> z odpowiednim formatem). +</ul> +<p> + + +<a name=AA1> +<h4>Dlaczego PLaTeX a nie Babel?</h4> + +(Fragment ten jest cytatem z listu nadesłanego na listę dyskusyjną GUST +przez Marcina Wolińskiego).<br> + +W porównaniu do pakietu Babel, PLaTeX ma kilka mniej lub bardziej +istotnych zalet: + +</para> +<ul> +<li> + PLaTeX udostępnia tradycyjne definicje nazw polskich funkcji + trygonometrycznych <code>\tg</code>, <code>\ctg</code>, <code>\arc</code> + i polskich znaków mniejsze-równe oraz większe-równe. +<li> + PLaTeX umie poprawne przenosić wyrazy złożone (tj. takie jak np. + biało-czerwony) udostępniając do tego celu polecenie <code>\dywiz</code>. +<li> + PLaTeX wstawia prawidłowe odstępy na końcu zdania. +<li> + Babel nie wspiera do końca fontów w układzie OT4 (fontów PL), + co powoduje, + że polskie znaki diakrytyczne w wyrazach wstawianych automatycznie + przez LaTeX (dokładnie ,,ę'' w słowie część oraz ,,ą'' w słowie + ,,załącznik'') sklejane z dwóch znaków. Jest to drobny, ale ciągle + nie usunięty błąd. (Można go poprawić samodzielnie dokonując niewielkiej + modyfikacji pliku polish.sty z dystrybucji pakietu Babel.) + Obwiedniowe fonty OT4 są niezastąpione przy tworzeniu plików + w formacie PDF. +</ul> +<para> + Podsumowując: jeżeli nie potrzebujemy środowiska wielojęzycznego to dużo + mniejsza objętość pakietu PLaTeX oznacza także mniejszą liczbę błędów + i potencjalnych kolizji z innymi częściami LaTeXa.<br> + [achiwum GUST-L, list z 06/06/1997] +</para> + +<hr> + +<h3>II. Użycie</h3> + +Aktualne implementacje, oparte na Web2c, a także MiKTeX pozwalają +na prawidłowe przekodowanie znaków diakrytycznych w pliku TeX-owym +na wewnętrzną reprezentację, stosowaną przez programy. +W Polsce, niestety, +stosowane są różne ,,standardy'' kodowania diakrytyków w tworzonych przez +użytkownika plikach, zależnie od systemu operacyjnego. Dla potrzeb systemu +TeX używamy zewnętrznych, tekstowych plików TCX, pozwalających ,,obsłużyć'' +różne spotykane ,,standardy''. Dzięki temu przekodowanie działa też +w drugą stronę, kiedy TeX wyświetla komunikaty i zapisuje pliki +<code>.log</code>, a także pliki ze spisem treści, skorowidzem itp.<p> + +Uruchomienie polecenia:<br> +<code>latex --translate-file=TCXFILE myfile.tex</code><br> +oznacza uruchomienia TeX-a z formatem <code>latex.fmt</code> +i z odpowiednią tablicą przekodowań (ich lista znajduje się +poniżej). W identyczny sposób uruchamiamy polecenie <code>platex</code>.<p> + +Przekodowanie (plik TCX) może być deklarowane bezpośrednio w pliku +TeX-owym. Począwszy od wersji Web2c 7.4, wymaga to podania +w wierszu poleceń opcji <code>--parse</code> lub włączenia jej na +stałe, co wymaga zmiany w głównym pliku +konfiguracyjnym <code>texmf.cnf</code>:<br> +<code>parse_first_line = t</code><br> +(t -- od `true', zamiast domyślnego przypisania f -- od `false'). + +<p> +Przykładowo, jeśli <b>pierwszy</b> wiersz pliku zawiera + komentarz strukturalny postaci<br> + <code>%&platex --translate-file=il2-pl</code><br> + to plik może być przetworzony za pomocą polecenia <code>tex plik.tex</code>; + zostanie wtedy wczytany format <code>platex.fmt</code> oraz tablica + <code>il2-pl.tcx</code> + przekodowania z układu iso8859-2 do układu fontów PL (wewnętrznego + dla programu TeX; w LaTeX-u ma on kryptonim OT4).<p> + +Tym samym zbędna jest deklaracja w preambule pliku LaTeX-owego:<br> + <code>\usepackage[latin2]{inputenc}</code><p> + <code>\usepackage[OT4]{fontenc}</code><p> + + +W dystrybucjach dostarczono szereg plikow TCX. Można je znaleźć +w katalogu <code>texmf/web2c/</code>:<br> +<table border> +<tr> + <td> amiga-pl.tcx </td> <td> AmigaPL do PL </td> +</tr> +<tr> + <td>il2-pl.tcx</td> <td> iso8859-2 (latin2) do PL </td> +</tr> +<tr> + <td>cp1250pl.tcx</td> <td> Windows cp1250 do PL </td> +</tr> +<tr> + <td>cp852-pl.tcx</td> <td> IBM cp852 do PL </td> +</tr> +<tr> + <td>macce-pl.tcx</td> <td> Apple MacCE do PL </td> +</tr> +<tr> + <td>maz-pl.tcx</td> <td> Mazovia do PL </td> +</tr> +</table> + +<p> +A oto przykład pliku LaTeX-owego: + +<pre> + %& --translate-file=cp1250pl + \documentclass[a4paper]{article} + \usepackage{polski} + \begin{document} + Polskie literki piszemy w standardzie Windows cp1250: ..... + \end{document} +</pre> + + Jak widać, nasz plik ma krótką preambułę -- pakiet <code>polski</code> + korzysta domyślnie z zainstalowanych fontów PL (odpowiada mu układ + OT4, więc zbędna jest deklaracja <code>\usepackage[OT4]{fontenc}</code>). + Jeśli korzystamy + z fontów EC nasza preambuła powinna zawierać dodatkowy wiersz:<br> + <code>\usepackage[T1]{fontenc}</code> + + +<h3> III. Polskie fonty PostScriptowe</h3> + + Aktualne dystrybucje zawierają fonty serii PL + (spolonizowane standardowe dla TeX-a fonty CM) w wersji + Type 1 (postscriptowe). + Można je także znaleźć w najbliższym węźle CTAN lub jego kopii, + np.:<br> + <code>ftp://sunsite.icm.edu.pl/CTAN/fonts/psfonts/polish/plpsfont/</code>.<br> + Pliki <code>.pfb</code> powinny znaleźć się w podkatalogu + <code>texmf/fonts/type1/public/pl/</code> naszej instalacji, zaś pliki + map fontowych (<code>.map</code>) oraz wektory kodowań +(<code>.enc</code>) -- w katalogu <code>texmf/dvips/pl/</code> +<p> +W dystrybucjach opartych na Web2c zautomatyzowano, poprzez użycie programu +<code>updmap</code>, proces tworzenia map fontowych dla programów +<code>dvips</code>, <code>pdftex</code> +i <code>dvipdfm</code>. Poniżej omówiono więc jedynie czego ten proces +dotyczy. +<p> + Sterownik <code>dvips</code> (zamieniający wynik pracy TeX-a, plik DVI, + do formatu PostScript) wymaga aby deklaracje map fontowych + (dla fontów PL konkretnie zawartość <code>texmf/dvips/pl/pl.map</code>) + były dołączone do pliku <code>texmf/dvips/config/psfonts.map</code>. + Mapy fontowe można alternatywnie dołączyć w pliku + <code>texmf/dvips/config/config.ps</code> (lub jego lokalnej kopii), + dopisując wiersz:<br> + <code>p +pl.map</code><br> + po deklaracji głównej mapy fontowej: <code>p psfonts.map</code>. <p> + + Aby fonty Type 1 były użyte przez program <code>pdfTeX</code>, + należy sprawdzić jakie mapy fontowe są deklarowane w pliku + <code>texmf/dvips/config/pdftex.map</code> -- powinien on także + zawierać deklaracje map fontowych dla fontów PL.<p> + +W dystrybucjach wszystkie aktualnie dostępne polskie fonty +Type1 są gotowe do użycia zarówno przez program <code>dvips</code>, +jak i <code>pdftex</code>.<p> + +Bardziej szczegółowe omówienie instalacji fontów Type1 zawarte +jest w artykule <a href="http://www.gust.org.pl/fonty/fonthint.html">Instalowanie +fontów Type1/True Type</a>. <p> + +<hr> + +<i>Staszek Wawrykiewicz</i> (StaW@gust.org.pl), 13.01.2003. + +</BODY> +</HTML> + diff --git a/Master/texmf-dist/doc/latex/platex/base/r22.mps b/Master/texmf-dist/doc/latex/platex/base/r22.mps new file mode 100644 index 00000000000..89c068fbe52 --- /dev/null +++ b/Master/texmf-dist/doc/latex/platex/base/r22.mps @@ -0,0 +1,78 @@ +%!PS +%%BoundingBox: -1 -22 158 72 +%%Creator: MetaPost +%%CreationDate: 1999.03.23:1034 +%%Pages: 1 +%*Font: plbx8 7.97011 7.97011 78:8 +%*Font: plr6 5.97758 5.97758 31:c +%*Font: plsy6 5.97758 5.97758 30:8 +%*Font: plex10 9.96265 9.96265 7a:f +%%EndProlog +%%Page: 1 1 + 0 0.5 dtransform truncate idtransform setlinewidth pop [] 0 setdash + 1 setlinecap 1 setlinejoin 10 setmiterlimit +newpath 0 0 moveto +102.04723 0 lineto stroke +newpath 98.35153 -1.53084 moveto +102.04723 0 lineto +98.35153 1.53084 lineto + closepath +gsave fill grestore stroke +newpath 0 0 moveto +153.07042 0 lineto stroke +newpath 149.37401 -1.53114 moveto +153.07042 0 lineto +149.37401 1.53114 lineto + closepath +gsave fill grestore stroke +newpath 0 0 moveto +56.69281 42.5196 lineto stroke +newpath 54.65497 39.07784 moveto +56.69281 42.5196 lineto +52.81812 41.52693 lineto + closepath +gsave fill grestore stroke + 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth + [3 3 ] 0 setdash +newpath 56.69281 0 moveto +56.69281 42.5196 lineto stroke + [] 0 setdash +newpath 0 0 moveto +0 70.86601 lineto stroke +59.69281 40.76117 moveto +(x) plbx8 7.97011 fshow +64.8457 43.57397 moveto +(0) plsy6 5.97758 fshow +64.8457 38.14436 moveto +(2) plr6 5.97758 fshow +97.39522 -6.5423 moveto +(x) plbx8 7.97011 fshow +102.54811 -7.6326 moveto +(1) plr6 5.97758 fshow +148.41841 -9.1337 moveto +(x) plbx8 7.97011 fshow +153.5713 -6.32089 moveto +(0) plsy6 5.97758 fshow +153.5713 -11.7505 moveto +(1) plr6 5.97758 fshow +2.8346 -7.1843 moveto +(|) plex10 9.96265 fshow + 0 1.1955 dtransform truncate idtransform setlinewidth pop 0 setlinecap +newpath 7.3178 -6.5865 moveto +23.86319 -6.5865 lineto stroke +23.86319 -7.1843 moveto +({z) plex10 9.96265 fshow +newpath 32.82959 -6.5865 moveto +49.375 -6.5865 lineto stroke +49.375 -7.1843 moveto +(}) plex10 9.96265 fshow + 0 0.5 dtransform truncate idtransform setlinewidth pop 1 setlinecap +newpath 0 -21.25981 moveto +8.50392 -8.50392 lineto stroke +newpath 7.72768 -12.4278 moveto +8.50392 -8.50392 lineto +5.1804 -10.72958 lineto + closepath +gsave fill grestore stroke +showpage +%%EOF diff --git a/Master/texmf-dist/doc/latex/platex/base/readme.txt b/Master/texmf-dist/doc/latex/platex/base/readme.txt new file mode 100644 index 00000000000..aca970483b5 --- /dev/null +++ b/Master/texmf-dist/doc/latex/platex/base/readme.txt @@ -0,0 +1,26 @@ +Copyright (C) 1994 by Mariusz Olko. All rights reserved. +Copyright (C) 1997 by Mariusz Olko and Marcin Woli\'nski. +Copyright (C) 2000,2002,2003 by Marcin Woli\'nski. + +Bundle `PLaTeX' provides tools to typeset documents in Polish using +LaTeX2e. Documented source code is in *.dtx and *.fdd files. + +`PLaTeX' is free software redistributable in according to LaTeX +Project Public License version 1 or above (see lppl.txt in base LaTeX +distribution). + +To install `PLaTeX' run TeX on instalation script platex.ins + tex platex.ins +which will extract individual pieces of the bundle from the *.dtx +files. + +During the instalation you will be asked question whether you have +`PL' fonts installed on your system or not. If you have them +installation script will generate a number of font description files +for Polish fonts. In case you don't have those font the ot4cmr.fd +file should not be present on the system, as it will confuse +environment scanning routine in `polski.sty'. + +More info can be found in documentation of polski.sty source code. To +obtain DVI file with documentation run + latex polski.dtx diff --git a/Master/texmf-dist/doc/latex/platex/base/tstlatex.tex b/Master/texmf-dist/doc/latex/platex/base/tstlatex.tex new file mode 100644 index 00000000000..284b36f2d78 --- /dev/null +++ b/Master/texmf-dist/doc/latex/platex/base/tstlatex.tex @@ -0,0 +1,117 @@ +%& --translate-file=il2-pl +%% Staszek Wawrykiewicz (staw@gust.org.pl). Styczeń 2000. Public domain. +%% Przykładowy plik LaTeX-owy; ilustruje proste polecenia składu, zmiany +%% kroju pisma i włączanie grafiki. +%% Plik przetwarzamy DWUKROTNIE z użyciem formatu platex: platex tstlatex +%% lub pdfplatex: pdfplatex tstlatex (w tym wypadku otrzymamy plik .pdf) +%% Warto obejrzeć cały plik! +% ========= +% Znak % w wierszu oznacza komentarz; od tego znaku +% do końca wiersza tekst jest ignorowany w składzie. +% Wyjątkiem jest pierwszy wiersz pliku, zaczynający się +% od znaków %& i zawierający deklarację użytego w tekście +% kodowania znaków. +% === dokumenty przetwarzane przez LaTeX-a mają obowiązkową preambułę: +\documentclass{article} +\usepackage{polski} % pakiet makr wspomagający skład w jęz. polskim + +\usepackage{graphicx} % pakiet makr do włączania grafiki do tekstu + % (deklarowany w razie potrzeby) + +\begin{document} % Rozpoczynamy! + +\tableofcontents % po drugim przetworzeniu pliku wygenerowany + % zostanie w tym miejscu spis treści + +\section{Proste teksty} + +Najpierw test polskich liter (iso8859-2): ąćęłńóśźż ĄĆĘŁŃÓŚŹŻ + +Jak zobaczysz po przetworzeniu tego pliku, kolejny akapit zaczyna się +wcięciem. Domyślnie ma ono wielkość 20~pt, ale, jak wszystko w~\TeX-u, +może to być zmienione. +Skład prostych tekstów jest bardzo łatwy; \TeX{} automatycznie łamie +akapity i~numeruje strony. Pisząc tekst nie musisz się martwić o~spacje, +wcięcia itp., skupiasz się tylko na treści. Wiele +spacji w~pisanym tekście czy wiersz złamany w~wygodnym +dla nas miejscu +da nam +identyczny efekt w~składzie. Zauważyłeś pewnie znaczek tyldy, który +pojawia się w~tekście źródłowym; służy on do zaznaczenia spacji, +na których \TeX{} nie powinien przełamać wiersza. +Pojedyncze litery na końcu wiersza nie wyglądają zbyt ładnie, prawda? + +\noindent % usuń wcięcie dla tego akapitu +Ten akapit nie ma wcięcia. Tekst składany jest domyślnym fontem 10~pt +o~nazwie plr10. \textit{To tekst kursywą}, a~to \textbf{tekst pogrubiony}. +I~znów przywracamy krój prosty. + +Jedną z~największych zalet systemu \TeX{} jest elegancki skład wyrażeń +matematycznych, nawet bardzo skomplikowanych, zarówno w~ramach samego +akapitu $\sum_{n\in A} {1\over n}$, jak i~wyeksponowanych w~osi strony: +\begin{equation} +\sum_{n\in A} {1\over n} +\end{equation} +Czy widzisz różnicę w składzie takiego samego zapisu? + +\section{Nieco bardziej skomplikowane} + +\LaTeX{} oferuje gotowe polecenia opisu struktury dokumentu. Zaczęliśmy +właśnie nową część dokumentu i~program sam ustalił kolejny numer +części, krój pisma i~jego wielkość dla wyróżnienia tytułu, wstawił +pionowe odstępy itd. + +Pokażemy teraz mechanizm odsyłaczy do równań matematycznych (patrz +równanie~\ref{eq:aa1}), jak i~do rysunków (patrz rys.~\ref{pic:bqq1}). +Odsyłacze mogą wskazywać miejsca w~dokumencie, nawet takie, które +występują w~dalszej jego części. Właśnie dla rozwiązania odesłań tekst +niniejszy powinien być przetworzony dwukrotnie. + +A~oto przykład bardziej skomplikowanego wyrażenia i~fragment tekstu +matematycznego: +\begin{equation} \label{eq:aa1} + e_{\min} = \frac{1}{t_I}\int_{t_1}^{t_2}|f(t)|^2 dt - + \sum_{i=1}^n |c_i|^2 \frac{e_i}{t_I}. +\end{equation} + +Rozpatrzmy trójwymiarową przestrzeń $\mathcal{V}$ rozpiętą na +trzech wzajemnie prostopadłych wektorach $\mathbf{x}_1$, +$\mathbf{x}_2$, $\mathbf{x}_3$ (rys.~\ref{pic:bqq1}). +Niech $\mathcal{W}$ będzie płaszczyzną (podprzestrzenią) w~przestrzeni +$\mathcal{V}$ rozpiętą na wektorach $\mathbf{x}_1$ i~$\mathbf{x}_2$. +Załóżmy, że istnieje wektor $\mathbf{y}$ należący +do przestrzeni $\mathcal{V}$, ale nie należący do płaszczyzny~$\mathcal{W}$ + +% wstawiamy rysunek utworzony w innym programie +\begin{figure}[!tbhp] +\hbox to\textwidth{\hss\includegraphics{r22.mps}\hss} +\caption{Ilustracja typowych przebiegów $x_n(t)$ \label{pic:bqq1}} +\end{figure} + +Rysunek~\ref{pic:bqq1} został utworzony przez program MetaPost i~nie ma +pewności, że zostanie prawidłowo wyświetlony przez program Windvi, YAP, czy +Xdvi (programy te wyświetlają wynik składu -- plik DVI i~głównie +przeznaczone są do oglądania tekstu). +Jeśli intensywnie korzystasz z~plików graficznych, warto wynik składu +przetworzyć programem Dvips: +\begin{verbatim} + dvips tstlatex -o tstlatex.ps +\end{verbatim} +i~oglądać \verb|tstlatex.ps| (plik PostScript-owy) w~przeglądarce GSview. + +\section{Zakończenie} + +Pokazane przykłady prezentują jedynie drobny fragment możliwości +\LaTeX-a. Więcej informacji znajdziesz np. w~podręczniku +,,Nie za krótkie wprowadzenie do systemu \LaTeX2$\epsilon$'', dostępnym +na: +\begin{verbatim} +http://www.gust.org.pl +\end{verbatim} + +A~teraz spróbuj złożyć taki sam dokument np. w~MS~Word! + +\end{document} +Po tym poleceniu możesz pisać dowolne komentarze. +I tak nie ukażą się w składzie. + |