%% Staszek Wawrykiewicz (StaW@gust.org.pl), January 2001. Public domain.
%% Staszek Wawrykiewicz (StaW@gust.org.pl), January 2001. Public domain.
%% Web2c (teTeX, fpTeX, TeX Live) and MiKTeX 2.0 revision
MeX and pdfMeX
Dokumentacja po polsku i po angielsku (niｿej).
The documentation in Polish and in English (below).
------------------------------------------------------------------------
POLSKI (iso8859-2):
------------------------------------------------------------------------
MeX jest adaptacjｱ formatu PLAIN TeX do skｳadu w j黝yku polskim
z uwzgl鹽nieniem polskich zwyczajw drukarskich.
Autorzy: Bogusｳaw Jackowski i Marek Ry詭o.
Dokumentacja poniｿsza omawia pokrtce tworzenie formatu mex.fmt (lub
pdfmex.fmt, dla programu pdfTeX -- wersji TeX-a tworzｱcej od razu pliki PDF)
i jego uｿycie w instalacji zgodnej z Web2c (dystrybucje teTeX, fpTeX, TeX
Live) a takｿe MiKTeX. Szczegｳowe informacje nt. pakietu MeX zawarto w pliku
mexinfo.pol.
W najnowszych dystrybucjach doｳｱczono prosty plik przykｳadowy
doc/polish/mex/tstmex.tex, sｳuｿｱcy do przetestowania poprawnego dziaｳania
formatu MeX. Poczｱtkujｱcym uｿytkownikom zaleca sizapoznanie z zawartoｶciｱ
tego pliku. Plik ten dost麪ny jest takｿe na serwerze GUST.
------------------------------------------------------------------------
I. Przygotowanie formatu MeX/pdfMeX (polskiej implementacji formatu Plain)
Przygotowanie formatu MeX (lub pdfMeX dla programu pdfTeX, tworzｱcego pliki
PDF) polega w skrcie na uruchomieniu:
tex --ini mex.ini
(dla pdfTeX: pdftex --ini pdfmex.ini). Podczas przetwarzania wczytywane sｱ
pliki makr formatu MeX, a takｿe plain.tex oraz wzorce przenoszenia wyrazw
dla j黝yka polskiego i angloamerykaskiego.
Poniewaｿ wygenerowany plik powinien znaleｼsiw odpowiednim miejscu
struktury katalogw, a takｿe powinien zosta,,zarejestrowany''
w instalacji, wspｳczesne dystrybucje uｳatwiajｱ proces generowania.
* W dystrybucjach opartych na Web2c (fpTeX, teTeX, TeX Live) formaty
generowane sｱ przy pomocy programu fmtutil (fmtutil --help wyｶwietla
dost麪ne opcje) zaｶ deklaracje formatw znajdujｱ siw pliku
texmf/web2c/fmtutil.cnf (gdy posiadamy drzewo katalogw zawierajｱce
lokalne pliki konfiguracyjne instalacji systemu TeX, program fmtutil
korzysta z lokalnej kopii fmtutil.cnf; dokｳadne poｳoｿenie pliku wyｶwietli
uruchomienie polecenia: kpsewhich fmtutil.cnf). W systemach Unix/Linux
caｳy proces generowania formatu dost麪ny jest z menu Formats programu
texconfig, ktre pozwala modyfikowaplik fmtutil.cnf, co polega na
usuni鹹iu znaku # przed deklacjｱ wybranego formatu bｱdｼ zablokowaniu
takim znakiem formatw niepoｿｱdanych. Po zapisaniu pliku format
zostanie automatyczne wygenerowany. W systemach Windows naleｿy
samodzielnie zmodyfikowaplik fmtutil.cnf, po czym uruchomipolecenie
fmtutil --byfmt=mex (lub fmtutil --byfmt=pdfmex).
* W MiKTeX (od wersji 2.0) naleｿy uruchomiw menu MiKTeX Options podmenu
TeX Formats, zaznaczyformat MeX (pdfMeX) i utworzy(przyciskiem
Build) potrzebny format.
W obu omawianych przypadkach tworzony jest plik formatu mex.fmt (lub
pdfmex.fmt), ktry jest kopiowany do wｳaｶciwego katalogu, zawierajｱcego
pliki formatw oraz tworzone jest polecenie mex lub pdfmex (uruchamia on
program tex z formatem mex lub program pdftex z formatem pdfmex).
------------------------------------------------------------------------
II. Uｿycie
Aktualne implementacje, oparte na Web2c 7.3, a takｿe MiKTeX pozwalajｱ
wreszcie na prawidｳowe przekodowanie znakw diakrytycznych w pliku TeX-owym
na wewn黎rznｱ reprezentacj 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. Do tego celu uｿywa sizewn黎rznych, tekstowych
plikw TCX. Co wi鹹ej, przekodowanie (plik TCX) moｿe bydeklarowane
bezpoｶrednio w pliku TeX-owym. Jeｶli pierwszy wiersz pliku zawiera komentarz
strukturalny postaci
%&mex --translate-file=il2-pl
to plik moｿe byprzetworzony za pomocｱ polecenia tex plik.tex; zostanie
wtedy wczytany format mex.fmt oraz tablica il2-pl.tcx przekodowania z ukｳadu
iso8859-2 do ukｳadu fontw PL (wewn黎rznego dla programu TeX). Moｿemy teｿ
uｿyc polecenia:
mex --translate-file=TCXFILE myfile.tex
lub deklaracjprzekodowania umieｶci(jak wyｿej) w pierwszym wierszu pliku.
mex jest tu poleceniem uruchomienia TeX-a z formatem mex.fmt -- polecenie
takie tworzy sikopiujｱc (w katalogu zawierajｱcym binaria) program tex do mex.
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
maz-pl.tcx Mazovia do PL
------------------------------------------------------------------------
III. Polskie fonty PostScriptowe
Aktualne dystrybucje zawierajｱ fonty serii PL 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 znajdujｱ siw podkatalogu texmf/fonts/type1/public/pl/ naszej
instalacji.
Sterownik dvips (zamieniajｱcy wynik pracy TeX-a, plik DVI, do formatu
PostScript) wymaga aby deklaracje map fontowych (dla fontw 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ｳｱczyw 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 sprawdzijakie
mapy fontowe sｱ deklarowane w pliku texmf/pdftex/config/psfonts.map --
powinien on takｿe zawieradeklaracje map fontowych dla fontw PL.
Bardziej szczegｳowe omwienie instalacji fontw Type1 zawarte jest
w artykule http://www.gust.org.pl/FONTY/fonthint.html.
-----------------------------------------------------------------------
ENGLISH:
------------------------------------------------------------------------
MeX is an adaptation of PLAIN TeX format to the Polish language and to the
Polish printing customs.
Authors: Bogus\l{}aw Jackowski & Marek Ry\'cko.
This document describes shortly creation of mex.fmt and usage in MiKTeX
environment. See mexinfo.eng for detailed informations about MeX.
I. Preparing MeX/pdfMeX (Polish Plain format)
* Web2c based distributions (teTeX, fpTeX, TeX Live). Invoke texconfig
and menu Formats, which edits fmtutil.cnf; uncomment mex (or pdfmex)
format; after saving the file, the desired format will be generated.
* MiKTeX (from ver. 2.0). Invoke `MiKTeX Options' menu and the submenu
`TeX Formats'. Select MeX (or pdfMeX). After pressing `Build' button
the format will be generated.
II. Usage: the current implementations based on web2c 7.3, 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 the _first_ line of TeX's file contains a structured comment
of the form
%&mex --translate-file=cp1250pl
it suffices to run `tex file.tex' with mex.fmt and cp1250pl.tcx
translation table (Windows cp1250 to internal PL reencoding).
You can also use the command
`tex &mex -tcx=TCXFILE myfile.tex'
or just `mex -tcx=TCXFILE myfile.tex' when you copy tex.exe into
mex.exe in the directory containing binaries .
Several TCX files are provided; they can be found in the texmf/web2c/
directory:
amiga-pl.tcx AmigaPL <--> PL encoding
il2-pl.tcx iso8859-2 (latin2) <--> PL encoding
cp1250-pl.tcx Windows cp1250 <--> PL encoding
cp852-pl.tcx IBM cp852 <--> PL encoding
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.
Dvips can be prepared for using PL fonts in Type 1 format in two ways:
* the contents of .../dvips/pl/pl.map should be included
into the standard .../dvips/config/psfonts.map.
* in .../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 line
map +pl.map
can be added to the contents of .../pdftex/config/pdftex.cfg, or
the contents of pdftex/config/psfonts.map file can be updated with
the contents of pl.map.
------------------------------------------------------------------------