diff options
author | Karl Berry <karl@freefriends.org> | 2009-05-19 18:23:55 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2009-05-19 18:23:55 +0000 |
commit | d5d90223f0e9217e546a1e53c78f73c1fddf1e87 (patch) | |
tree | 75f8120f34df071de492ca416b86623e3af154d3 /Master/texmf-dist/doc/generic/tex-virtual-academy-pl/poczatki/mex.html | |
parent | 74ba81e08ea1a80aeba3b4bfbf7acc5f07853b0b (diff) |
move out of texmf-doc
git-svn-id: svn://tug.org/texlive/trunk@13240 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/tex-virtual-academy-pl/poczatki/mex.html')
-rw-r--r-- | Master/texmf-dist/doc/generic/tex-virtual-academy-pl/poczatki/mex.html | 224 |
1 files changed, 224 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/tex-virtual-academy-pl/poczatki/mex.html b/Master/texmf-dist/doc/generic/tex-virtual-academy-pl/poczatki/mex.html new file mode 100644 index 00000000000..331909e7824 --- /dev/null +++ b/Master/texmf-dist/doc/generic/tex-virtual-academy-pl/poczatki/mex.html @@ -0,0 +1,224 @@ +<HTML> +<HEAD> +<meta http-equiv="content-type" content="text/html; charset=iso-8859-2"> +<TITLE>MeX, pdfMeX</TITLE> +</HEAD> + +<BODY> + +<!-- May 2008. Staszek Wawrykiewicz (StaW at gust.org.pl). +TeX Live 2008 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 wersji TeX-a tworzącej +od razu pliki PDF) +i jego użycie w instalacji zgodnej z <code>Web2c</code> +(dystrybucje teTeX, 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/base/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/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 do tworzenia +plików PDF) polega w skrócie na uruchomieniu: +<pre> +<em>tex-engine</em> --ini mex.ini +</pre> + +gdzie <em>tex-engine</em> oznacza program <code>tex</code> lub +<code>pdftex</code>. Obecnie, od Web2c wer. 7.5.5, używamy jednego programu: +<code>pdftex</code>, zaś ,,sposób'' generowania formatu (dla tworzenia +plików DVI lub PDF) zależny jest od zawartości pliku <code>.ini</code>. +Zatem format do tworzenia plików PDF generujemy obecnie poleceniem: +<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 (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>pdftex</code> +z formatem <code>mex</code> bądź +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 (obecnie) <code>pdftex</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'). --> +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>pdftex 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 w wersji +Type 1 (postscriptowe) serii PL +(spolonizowane standardowe dla TeX-a fonty CM), a także znacznie +rozszerzone i obecnie zalecane fonty Latin Modern. + Można je także znaleźć w najbliższym węźle CTAN lub jego kopii, + np.:<br> + <a href="ftp://ftp.gust.org.pl/pub/CTAN/language/polish/plpsfont/"> +ftp://ftp.gust.org.pl/pub/CTAN/language/polish/plpsfont/</a>.<br> + <a href="ftp://ftp.gust.org.pl/pub/CTAN/fonts/lm/"> +ftp://ftp.gust.org.pl/pub/CTAN/fonts/lm/</a>.<p> + +Przedstawimy tu przykład dotyczący instalacji fontów PL. + Pliki <code>.pfb</code> powinny znaleźć się w podkatalogu + <code>texmf/fonts/type1/public/pl/</code> naszej instalacji, pliki + map fontowych (<code>.map</code>) w katalogu + <code>texmf/fonts/map/dvips/pl/</code> zaś wektory kodowań +(<code>.enc</code>) -- w katalogu <code>texmf/fonts/enc/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>dvipdfmx</code>. Poniżej omówiono więc tylko, 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/fonts/map/dvips/pl/pl.map</code>) + były dołączone do pliku <code>texmf/fonts/map/dvips/updmap/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/fonts/map/pdftex/updmap/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>, +<code>pdftex</code>, jak i <code>dvipdfmx</code> .<p> + +Bardziej szczegółowe omówienie instalacji fontów Type1 zawarte +jest w artykule <a href="../fonty/fonts_inst.html">Instalowanie +fontów Type1/True Type</a>. <p> + +<hr> + +<i>Staszek Wawrykiewicz</i> (StaW at gust dot org dot pl), 30.05.2008. + +</BODY> +</HTML> + |