summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/platex/base/00readme
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/platex/base/00readme')
-rw-r--r--Master/texmf-dist/doc/latex/platex/base/00readme307
1 files changed, 0 insertions, 307 deletions
diff --git a/Master/texmf-dist/doc/latex/platex/base/00readme b/Master/texmf-dist/doc/latex/platex/base/00readme
deleted file mode 100644
index 3ac6e0794fd..00000000000
--- a/Master/texmf-dist/doc/latex/platex/base/00readme
+++ /dev/null
@@ -1,307 +0,0 @@
-%% 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.
-
----------------------------------------------------------------------------