# Instalowanie PLaTeX-a

## Co to jest PLaTeX?

PLaTeX to kolejna wersja pakietu ,,po polsku'', który umożliwia składanie tekstów w języku polskim pod LaTeX-em. Autorami pakietu są Mariusz Olko i Marcin Woliński.

## Instalacja

### Potrzebne pliki

Zakładam, że masz już zainstalowanego teTeX-a. Poniższy opis dotyczy teTeX-a 0.9, ale powinien być aktualny także dla innych wersji. Interesować nas będzie przede wszystkim drzewo katalogu texmf. Może on znajdować się w /usr/local/teTeX (tak jest przy standardowej instalacji teTeX-a), w /usr/lib (przy instalowanie teTeX-a z pakietu RPM lub DPKG), a w przypadku gdy korzystasz z PLD powinieneś szukać go w /usr/share.

Jeżeli masz kłopoty ze znalezieniem katalogu texmf, spróbuj wydać polecenie:

        locate texmf

lub

        find / -type d -name texmf

W dalszej części opisu będą używane ścieżki względne texmf/.

Do pełnej instalacji potrzebne będą następujące pliki:

- PLaTeX
- Czcionki MF
- Czcionki TFM

### Instalacja czcionek

Zawartosc archiwum pl-mf.zip przegraj do texmf/fonts/source/public/pl.

Archiwum pl-tfm.zip rozpakuj do texmf/fonts/tfm/public/pl.

Po zakończeniu tych operacji drzewo katalogów w texmf/fonts powinno mieć postać:

        ...
        source ----+
                   +----ams
                   +----jknapen
                   +----public----pl----+
                                        +---- cmbx11.mf
                                        +---- cmr11.mf
                                        +---- cmsl11.mf
                                        +.....
        tfm -------+
                   +----adobe
                   +----ams
                   +----bitstrea
                   +----public----pl----+
                                        +---- plb10.tfm
                                        +---- plbsy10.tfm
                                        +---- plbx10.tfm
                                        +.....

Niektóre katalogi mogą u Ciebie nie wystąpić.

### PLaTeX

Rozpakuj archiwum platex.zip do katalogu texmf/tex/latex/platex. Następnie wykonaj polecenie:

        latex platex.ins

na pytanie o czcionki pl zainstalowane w systemie odpowiedz tak, (przecież przed chwilą je zainstalowałeś). Teraz pozostaje już tylko uruchomić program `texconfig` i wybrać kolejno:

- `rehash`
- `hyphen` i usunąć znak % z linii zawierającej słowo ,,polish''

teTeX powinien wygenerować potrzebne formaty i od tej chwili możemy już pisać po polsku!

## Zakończenie

Aby sprawdzić poprawnośc instalacji utwórz następujący plik test.tex:

    \documentclass[a4paper,12pt]{article}
    \usepackage{polski}
    \usepackage[latin2]{inputenc}
    \begin{document}
    ąćęłńóśżź \\
    ĄĆĘŁŃÓŚŻŹ \\
    \end{document}

a następnie przetwórz go poleceniem latex test.

LaTeX powinien wypisać na przykład coś takiego:

    This is TeX, Version 3.14159 (Web2C 7.2)
    (test
    LaTeX2e <1998/06/01>
    (/usr/share/texmf/tex/latex/base/article.cls
    Document Class: article 1998/05/05 v1.3y Standard LaTeX document class
    (/usr/share/texmf/tex/latex/base/size12.clo)) (polski.sty
    Document Language Style `polski' v1.0 <1997/11/07> (MOl)
       Switching to Polish text encoding and Polish maths fonts.
    (ot4enc.def) (ot4cmr.fd)) (/usr/share/texmf/tex/latex/base/inputenc.sty
    beta test version (/usr/share/texmf/tex/latex/base/latin2.def))
    No file test.aux.

    Underfull \hbox (badness 10000) in paragraph at lines 5--7

    [1] (test.aux) )
    (see the transcript file for additional information)
    Output written on test.dvi (1 page, 264 bytes).
    Transcript written on test.log.

Jeżeli wystąpił błąd, sprawdź czy dokładnie przepisałeś przykład i czy nie zapomniałeś o wydaniu polecenia `texconfig`. Teraz możesz wybrać jeden z dwóch wariantów:

1. obejrzeć plik wynikowy test.dvi programem xdvi (dla znawców)
2. dokonać konwersji test.dvi na postscript poleceniem:

       dvips -o test.ps test.dvi

   a następnie obejrzeć test.ps używając dowolnego front-endu do ghostscriptu (ghostview, gv (polecam), czy przeglądarki z KDE)

Polskie literki powinny pojawić się w pełnej krasie.
Gratulacje! Teraz możesz pisać w LaTeX-u po polsku!

## Podziękowania

Autor serdecznie dziękuje Marcinowi Wolińskiemu i Staszkowi Wawrykiewiczowi za cenne uwagi i pomoc przy opracowaniu tego tekstu.

Last modified: Tue Jan 12 00:45:00 MET 1999