diff options
Diffstat (limited to 'Master/texmf-dist/doc/mex/base/mex.html')
-rw-r--r-- | Master/texmf-dist/doc/mex/base/mex.html | 212 |
1 files changed, 212 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/mex/base/mex.html b/Master/texmf-dist/doc/mex/base/mex.html new file mode 100644 index 00000000000..6301bbfd8e5 --- /dev/null +++ b/Master/texmf-dist/doc/mex/base/mex.html @@ -0,0 +1,212 @@ +<HTML> +<HEAD> +<meta http-equiv="content-type" content="text/html; charset=iso-8859-2"> +<TITLE>MeX, pdfMeX</TITLE> +</HEAD> + +<BODY> + +<!-- January 2003. Staszek Wawrykiewicz (StaW@gust.org.pl). +teTeX 2.0 revision. Public domain. --> + +<center> +<h2>MeX i pdfMeX</h2> +</center> +MeX jest adaptacją formatu Plain TeX do składu w języku polskim +z uwzględnieniem polskich zwyczajów drukarskich.<br> +Autorzy: Bogusław Jackowski i Marek Ryćko.<br> +Dokumentacja poniższa omawia pokrótce tworzenie formatu <code>mex.fmt</code> +(lub <code>pdfmex.fmt</code>, dla programu pdfTeX -- wersji TeX-a tworzącej +od razu pliki PDF) +i jego użycie w instalacji zgodnej z <code>Web2c</code> +(dystrybucje teTeX, fpTeX, TeX Live) a także MiKTeX. +Szczegółowe informacje nt. pakietu MeX zawarto w pliku +<code>mexinfo.pol</code>. + +<p> +W dystrybucji dołączono ponadto prosty plik przykładowy +<code>doc/polish/mex/tstmex.tex</code>, służący do przetestowania poprawnego +działania formatu MeX. 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>. + +<hr> + +<h3>I. Przygotowanie formatu MeX/pdfMeX (polskiej implementacji formatu Plain)</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>.<p> + +Przygotowanie formatu MeX (lub pdfMeX dla programu pdfTeX, tworzącego +pliki PDF) polega w skrócie na uruchomieniu: +<pre> +tex --ini mex.ini +</pre> +(dla pdfTeX: <code>pdftex --ini pdfmex.ini</code>). Podczas przetwarzania +wczytywane są pliki makr formatu MeX, a także +<code>plain.tex</code> oraz wzorce przenoszenia wyrazów dla języka polskiego +i angloamerykańskiego. + +<p> +Ponieważ wygenerowany plik powinien znaleźć się w odpowiednim +miejscu struktury katalogów, a także powinien zostać ,,zarejestrowany'' +w instalacji, współczesne dystrybucje ułatwiają proces generowania. + +<ul> +<li>W dystrybucjach +opartych na Web2c (fpTeX, teTeX, TeX Live) formaty generowane są przy pomocy +programu <code>fmtutil</code> (<code>fmtutil --help</code> wyświetla dostępne +opcje) zaś deklaracje formatów znajdują się w pliku +<code>texmf/web2c/fmtutil.cnf</code> (gdy posiadamy drzewo katalogów +zawierające lokalne pliki konfiguracyjne instalacji systemu TeX, program +<code>fmtutil</code> korzysta z lokalnej kopii <code>fmtutil.cnf</code>; +dokładne położenie pliku wyświetli uruchomienie polecenia: +<code>kpsewhich fmtutil.cnf</code>).<br> +W systemach Unix/Linux cały proces generowania formatu dostępny jest +z menu <code>Formats</code> programu <code>texconfig</code>, które +pozwala modyfikować plik <code>fmtutil.cnf</code>, +co polega na usunięciu znaku # +przed deklacją wybranego formatu bądź zablokowaniu takim znakiem +formatów niepożądanych. Po zapisaniu pliku i zakończeniu edycji, +format zostanie automatyczne wygenerowany.<br> +W systemach Windows +należy samodzielnie zmodyfikować plik <code>fmtutil.cnf</code>, po czym +uruchomić polecenie <code>fmtutil --byfmt=mex</code> +(lub <code>fmtutil --byfmt=pdfmex</code>). + +<li> +W MiKTeX (od wersji 2.0) +należy uruchomić w menu <code>MiKTeX Options</code> podmenu +<code>TeX Formats</code>, zaznaczyć format +<code>MeX</code> (<code>pdfMeX</code>) i utworzyć (przyciskiem +<code>Build</code>) potrzebny plik formatu. +</ul> + +<p> +W obu omawianych przypadkach tworzony jest plik formatu +<code>mex.fmt</code> (lub <code>pdfmex.fmt</code>), który jest +umieszczany w katalogu właściwym dla tego rodzaju +plików, oraz tworzony jest program <code>mex</code> lub <code>pdfmex</code> +(uruchamia on program <code>tex</code> +z formatem <code>mex</code> bądź program <code>pdftex</code> +z formatem <code>pdfmex</code>).</p> + +<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>mex --translate-file=TCXFILE myfile.tex</code><br> +oznacza uruchomienia TeX-a z formatem <code>mex.fmt</code> +i z odpowiednią tablicą przekodowań (ich lista znajduje się +poniżej). Polecenie <code>mex</code> tworzone jest zwykle jako dowiązanie +do programu <code>tex</code> w katalogu zawierającym binaria.<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>%&mex --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>mex.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).<p> + + W dystrybucjach dostarczono szereg plikow TCX. Można je znaleźć + w katalogu <code>texmf/web2c/</code>: + +<p> +<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> + +<hr> + +<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> + |