  JJak tto zzrobi (JTZ) czyli HOWTO po polsku
  piotr.pogorzelski@ippt.gov.pl
  v2.3.4 Luty 1998

  Inforamcje co to takiego JTZ, skd si to wzio, czemu to ma suy,
  komu to jest potrzebne, a komu nie. Najnowsza wersja tego dokumentu
  znajduje si pod adresem ftp.jtz.org.pl <ftp://ftp.jtz.org.pl:/JTZ/>
  oraz na Polskiej Stronie Tumacze <http://www.jtz.org.pl/Html/JTZ-
  HOWTO.pl.html>.  Chciabym zauway, e dokument ten do czsto si
  zmienia, wic pilnuj prosz czy masz najnowsz wersj. Szczeglnie
  zwracam uwag na sowniczek.
  ______________________________________________________________________

  Table of Contents:

  1.      Co to jest JTZ ?

  2.      Ustalenia, ktre stay si obowizujcym prawem.

  3.      Ludzie, czyli kto to robi

  4.      Pierwsze rezultaty

  5.      Przetumaczone dokumenty

  6.      Sownik

  7.      Jak korzysta z trybu psgml pod Xemacsem?

  8.      Troch danych techicznych dla tumaczy.

  8.1.    Krtki minikurs SGML-a.

  9.      Co mam zrobi jeli chc poprawi dokument.

  10.     Konwersja SGML -> LaTeX a sprawa polska

  10.1.   LaTeX i LaTeX2e (epsilon)

  10.2.   Co nam generuje sgml2latex ?

  10.3.   Program sgml2latex i pliki DVI oraz PS

  10.4.   Konwersja waciwa, czyli jak uzyska DVI lub PS

  10.5.   Uwagi
  ______________________________________________________________________

  11..  CCoo ttoo jjeesstt JJTTZZ ??

  Wszystko zaczo si od tego, e kilku osobom chciao si powici
  troche czasu (bynajmniej nie wolnego) (cho jeden z nich sugerowa, e
  podobno mia mie jakie ferie, czy co w tym stylu, lecz przecie
  kady rozsdny czowiek wie, e nie ma czego takiego jak ferie,
  urlop, wolna chwila. To s puste pojcia wymylone przez *owcw, ktre
  maj jedynie namci ludziom w gowach) i wspomc World Linux
  Domination Project Polska (cho cz z nich na pewno sobie nie
  zdawaa sprawy z tego co robi) tumaczc HOWTO na nasz rodzimy jzyk.

  Dosy szybko zebraa si maa grupka ludzi, ktrzy rzuciwszy w kt
  inne sprawy zabrali si do dyskusji co przetumaczy, jak to
  przetumaczy i co z tymi tumaczeniami robi. Na szczcie nie byli w
  tym najlepsi (w tumaczeniach te nie, jak sami zobaczycie), wic si
  zajli innym sprawami (wesela, kino, spacer itp.).

  Ku oglnemu zdziwieniu okazao si, e ich wysiek nie poszed na
  marne i zaczy pojawia si pierwsze efekty ich dziaa (o nich za
  chwil).  Rwnie ich dyskusje, zaowocoway pewnymi ustaleniami, ktre
  od tej pory stay si obowizujcym prawem.

  Osob koordynujc projekt jest Bartosz Maruszewski
  <mailto:B.Maruszewski@jtz.org.pl>

  22..  UUssttaalleenniiaa,, kkttrree ssttaayy ssii oobboowwiizzuujjccyymm pprraawweemm..

  Te ogniste dyskusje, o ktrych wczeniej pisaem (wymiana kilkunastu
  listw midzy trzema osobami) doprowadziy do przyjcia nastpujcych
  zasad :

    Postanowilimy, e kady kto chce dooy swoj cegiek do tego
     projektu, zanim cokolwiek zacznie robi, powinien si z nami
     skontaktowa i sprawdzi, czy to co chce robi nie zostao ju
     przez kogo wzite. Wylij list na adres B.Maruszewski@jtz.org.pl
     <mailto:B.Maruszewski@jtz.org.pl> i zatytuuj go "HOWTO-info"
     (wielko liter ma znaczenie). Otrzymasz wtedy dokadn list kto
     co robi i jakie dokumenty s wolne.

    Jeli dokument jest "wolny", zanim si go zacznie tumaczy trzeba
     o tym poinformowa osob koordynujc rozdzia dokumentw
     (B.Maruszewski@jtz.org.pl).

    Upewnij si, e posiadasz najnowsz wersj dokumentu (po co si
     mczy dwa razy?) i sprawd czy autor nie ma jakich zastrzee co
     do tumaczenia.  ZZaawwsszzee informuj autora, e chcesz przetumaczy
     jego dokument. Moesz zacz tumaczy od razu po wysaniu listu,
     nie czekajc na odpowied, bo szansa, e autor si nie zgodzi jest
     raczej jak 1:1 000 000 :)

    Jeli jest dostpna wersja oryginau w sgml, to tumacz raczej j.

    WW ttuummaacczzeenniiaacchh wwyykkoorrzzyyssttuujjeemmyy oopprraaccoowwaannyy wwssppllnniiee ssoowwnniikk,
     starajc si zachowa wsplne sownictwo (niestety trzeba
     zrezygnowa z ulubionych zwrotw). Sownik taki otrzymasz wysyajc
     list na adres B.Maruszewski@jtz.org.pl
     <mailto:B.Maruszewski@jtz.org.pl> i tytuujc go "HOWTO-slownik".
     Zapoznaj si z nim przed rozpoczciem tumaczenia - uchroni ci to
     od niepotrzebnych, dugotrwaych poprawek.  Sownik ten znajduje
     si take w tym dokumencie.

    Kady nagwek pliku ma wyglda tak samo. Skopiuj poniszy i zmie
     dane:

       <title>Tytu<newline>
       <author>Autor: Imi Nazwisko
       <htmlurl url="mailto:autor@adres"
       name="autor@adres"><newline>
       v0.75, 1 Sierpnia 1996<newline> <-- wersja i data oryginau
       <bf>Wersja polska: Imi Nazwisko tumacza
       <htmlurl url="mailto:tumacz@adres" name="tumacz@adres"><newline>
       </bf>
       v1.3, 28 Marca 1997 <-- wersja i data tumaczenia

       Zawsze umieszczaj t sekcj. Z reguy autorzy take j umieszczaj.
       Dodaj tylko od siebie dwie ponisze informacje. Jeli jej nie ma, to
       za j z tymi informacjami.
       <abstract>
       Dokument ten zosta napisany w standardzie ISO-8859-2.
       Orygina tego dokumentu znajduje si pod adresem...  _j_e__l_i _a_u_t_o_r _n_i_e
  _p_o_d_a__, _t_o _p_o_d_a_j _f_t_p_._i_c_m_._e_d_u_._p_l_/_p_u_b_/_L_i_n_u_x_/_s_u_n_s_i_t_e_/_d_o_c_s_/_H_O_W_T_O_/_(_m_i_n_i_)
  </abstract>

  Zwr szczegln uwag na wszystkie newline.

    Wszystkie teksty piszemy w formacie sgml (linuxdoc) kodujc polskie
     litery w obowizujacym standardzie (dla nieuwiadomionych dodam, e
     nazywa si on ISO-8859-2).

    Zajmujemy si tylko tumaczeniem, cho bardzo bymy chcieli nie
     moemy jednoczenie aktualizowa tumaczonych dokumentw.
     Aktualizowa oznacza, e nie moemy weryfikowa danych znajdujcych
     si w oryginale. Jeli orygina zostanie zaktualizowany, to kady
     tumacz jest zobowizany do uaktualnienia swojego tumaczenia.

    Kady dokument musi zawiera rozdzia, w ktrym podane s wszelkie
     wprowadzone zmiany w stosunku do oryginau.
     Najlepiej na kocu zatytuowany OOdd ttuummaacczzaa.

    Tumaczymy dokumenty HOWTO. Jeli w przyszoci ich nam zabraknie,
     by moe wemiemy si za co innego.

    Nazw plikw nie tumaczymy, Installation-HOWTO pozostanie dalej
     Installation-HOWTO. Dodajemy jedynie rozszerzenie ..ppll..ssggmmll.

    Jak ju przetumaczysz, sprawdzisz i stwierdzisz, e mona
     tumaczenie odda do uytku, to przedtem sprawd, czy dokument
     mona przekonwertowa na wersj html i txt.
     Dla nieznajcych sgml-a podam, e aby polskie litery zostay
     nienaruszone przy konwersji na wersj txt naley polecenie sgml2txt
     wykona z opcj -l.

    Po przetumaczeniu i sprawdzeniu powyszego poinformuj osob
     koordynujc, czyli B.Maruszewski@jtz.org.pl
     <mailto:B.Maruszewski@jtz.org.pl>, e skoczye tumaczy dany
     dokument, a otrzymasz wtedy haso dla dostpu do katalogu .private
     na serwerze ftp. Oraz w celu jak najszybszego umieszczenia
     dokumentu w archwium na stronie WWW. Umie dokument w wersji sgml
     (konwersja nastpi automatycznie) pod adresem _f_t_p_._j_t_z_._o_r_g_._p_l w
     katalogu:

    _/_J_T_Z_/_._p_r_i_v_a_t_e_/_g_o_t_o_w_e jeli jest to HOWTO

    _/_J_T_Z_/_._p_r_i_v_a_t_e_/_g_o_t_o_w_e_/_m_i_n_i jeli jest to mini-HOWTO

     Serwerem ftp zajmuje si PPiioottrr PPooggoorrzzeellsskkii i prosz kierowa
     wszelkie uwagi i komentarze ddoo nniieeggoo.

    Jeli pracujesz nad obszernym dokumentem i chcesz udostpni jaki
     zrobiony fragment, to suy do tego celu katalog /wersje_robocze na
     serwerze ftp, ktry nie jest kopiowany na lustrach ftp. W sprawie
     szczegw skontaktuj si z Piotrem Pogorzelskim.

    Oprcz numeracji oryginau stosujemy take numeracj tumaczenia.
     Patrz kilka punktw wyej na temat nagwka pliku sgml. Numeracja
     ta jest niezalena od numeracji oryginau i zawsze zaczynamy od
     wersji 1.0

    Jeli zmieniasz wersj tumaczenia, to zastosuj si do poniszych
     regu:

    Jeli s to due poprawki/zmiany, np.: przerbka kilku sekcji,
     likwidacja niektrych, dodanie nowych, to zmie wersj gwn ((11..00
     -->> 22..00))
    Jeli s to rednie poprawki/zmiany, np.: poprawka wikszej iloci
     bdw zmiana kilku adresw, to zmie wersj poboczn ((11..11 -->> 11..11))

    Jeli s to mae poprawki/zmiany, np.: usunicie paru literwek,
     zmiana jednego/dwch adresw, to zmie drug cyfr po przecinku
     ((11..00 -->> 11..0011))

     Bdzie to uatwienie dla uytkownikw, ktrzy bd wiedzie czy
     opaca si ciga now wersj czy nie.

    Jeli jest to moliwe, to staraj si w miar postpowania prac nad
     danym dokumentem podawa ich procentowe zaawansowanie. Odpowiedni
     formularz jest na WWW.

    Jeli w dokumencie znajduje si odwoanie do przetumaczonego ju
     HOWTO, to zrb odwoanie do tego tumaczenia a nie oryginau.
     Tumaczenia na serwerze WWW znajduj si w katalogach:

    Html/ - HOWTO

    Html/mini - mini-HOWTO

     Nazwa pliku to:

    Nazwa-HOWTO.pl.html - HOWTO

    Nazwa.pl.html - mini-HOWTO

    Jeli uaktualniasz swoje tumaczenie, to bardzo prosz przylij
     osobie koordynujcej, czyli mnie (_B_._M_a_r_u_s_z_e_w_s_k_i_@_j_t_z_._o_r_g_._p_l)
     wiadomo, e to zrobie, ebym mg umieci nowsz wersj na
     WWW.  Przecie nie mog myle o wszystkim.

    Pytacie czasami czy moecie wstawia wasne tagi (<bf> <tt> itd.).
     Ot adnych zasad na ten temat nie wypracowalimy. Ja tumacz
     dokument tak jak jest i nie upikszam go, bo nie mam czasu i mi si
     nie chce. Wg. mnie jeli chcesz sie pobawi - prosz bardzo.

    Zastanawiacie si take, czy mona uywa "mniej oficjalnych" sw.
     Ot wg. mnie takie HOWTO jest pisane przez ludzi i dla ludzi i nie
     jest to adne rzdowe pismo super oficjalne itp. Ju nie raz
     widziaem taki slang, e po kilkukrotnym przeczytaniu nie
     wiedziaem o co chodzi... Jednak naley pamita o pewnym
     umiarze... nie przesadzajmy :)

    Zdarzaj sie czasami takie wyraenia, ktre ciko przetumaczy na
     polski i wychodz z tego jakie dziwolgi jzykowe albo w ogle nie
     maj odpowiednika w j. polskim. W takim przypadku przetumacz to,
     ale podaj dodatkowo w nawiasie wersj oryginaln wyraenia. Stosuj
     to take jeli tumaczenie jest dwuznaczne

  33..  LLuuddzziiee,, cczzyyllii kkttoo ttoo rroobbii

  CChhwwiilloowwoo jest nas niewielu. Ci, o ktrych wiemy (by moe s tacy,
  ktrzy samotnie, w zapomnieniu  zrobili ju t ca robot, lecz my o
  nich nic nie wiemy) to:

    [mg] Maciek Grochal frytek@tichy.ch.uj.edu.pl

    [bm] Bartosz Maruszewski B.Maruszewski@jtz.org.pl

    [po] Pawko Olszewski alder@amg.com.pl

    [pp] Piotr Pogorzelski piotr.pogorzelski@ippt.gov.pl

    [pt] Piotr Tczyski pteczyn@hum.amu.edu.pl

    [zb] Ziemek Borowski ziembor@digilab.com.pl

    [bb] Benedict P. Barszcz poseidon@mail.ziplink.net

    [jc] Jakub Chmielewski yacoob@manager.ae.wroc.pl

    [jb] Janusz Batko janus@krakow.linux.org.pl

    [ps] Pawe wierszcz vampire@aule.mdkna102.krakow.pl

    [jp] Jacek Pliszka Jacek.Pliszka@fuw.edu.pl

    [gsn] Gwidon S. Naskrent naskrent@hoth.amu.edu.pl

    [zb] Zbigniew von Borgosz borg@kki.net.pl

    [bp] Bartek Papierski bartekp@dom.vr.pl

    [pd] Piotr DUDA s0074@pjwstk.waw.pl

    [mm] Micha Malarski malarz@it.pw.edu.pl

    [gn] Grzegorz Nalepa nalepa@ibm.uci.agh.edu.pl

  Jeli chcesz do nas doczy zapisz si na nasz list, lecz pamitaj,
  e jest ona przeznaczona, dla osb pprraaccuujjccyycchh nad tumaczeniami, nie
  suy do przygldania si, jak postpuj prace. Adres listy to
  _j_t_z_@_i_p_p_t_._g_o_v_._p_l lub _j_t_z_@_j_t_z_._o_r_g_._p_l. Aby si na ni zapisa wylij na
  adres listproc@ippt.gov.pl <mailto:listproc@ippt.gov.pl> list
  zawierajcy

       subscribe jtz Imi Nazwisko

  Pawe Wicek _c_o_v_e_n_@_p_w_r_._w_r_o_c_._p_l _<_m_a_i_l_t_o_:_c_o_v_e_n_@_p_w_r_._w_r_o_c_._p_l> _o_p_i_e_k_u_j_e _s_i_
  _p_a_k_i_e_t_e_m _n_a_s_z_y_c_h _t__u_m_a_c_z_e_ _d_o_s_t_a_r_c_z_a_n_y_m _d_l_a _D_e_b_i_a_n_-_a_.  _P_a_k_i_e_t _t_e_n _j_e_s_t
  _d_o_s_t__p_n_y _j_a_k_o _"_u_n_s_t_a_b_l_e _d_o_c_-_l_i_n_u_x_-_p_l_" pod adresem ftp.ists.pwr.wroc.pl
  <ftp://ftp.ists.pwr.wroc.pl:/coven/debian> lub na dowolnej kopii
  serwera _f_t_p_._d_e_b_i_a_n_._o_r_g. On te postawi mirror we Wrocawiu pod tym
  samym adresem, ale w innym katalogu - /pub/linux/JTZ/.

  44..  PPiieerrwwsszzee rreezzuullttaattyy

  Postanowilimy, e przetumaczone dokumenty bd udostpniane
  szerszemu gronu dopiero, kiedy bd si  do tego nadaway ;-).  To
  znaczy, e przetumaczony dokument musi wpierw troche poczeka, zosta
  ponownie sprawdzony przez autora i dopiero potem moe pokaza si
  szerszej publicznoci. Lecz na pocztku jedynie w postaci _h_t_m_l, _t_x_t i
  _s_g_m_l.

  Chcemy jednak, abycie wiedzieli czego moecie oczekiwa w najbliszym
  czasie i jaki jest stopie zaawansowania prac. Czekamy rwnie na
  wasze reakcje i oczekiwania. Wasze gosy mog wpyn na kolejno w
  jakiej bd tumaczone te dokumenty. Zajrzyj na stron WWW
  www.jtz.org.pl <http://www.jtz.org.pl/>.

  Jeli chcesz wiedzie nad czym w tej chwili pracujemy, wylij na adres
  B.Maruszewski@jtz.org.pl <mailto:B.Maruszewski@jtz.org.pl> list, ktry
  w polu SSuubbjjeecctt:: zawiera napis HOWTO-info (wielko liter ma
  zanaczenie).  Otrzymasz mniej wicej tak odpowiedz:

       From: Bartosz Maruszewski <bart@mat.uni.torun.pl>
       Subject: Re: HOWTO-info
       Date: Tue, 25 Feb 1997 16:47:27 +0100 (MET)
       Lines: 38

       ========== KTO ========== ===== CO ROBI ===== ===== CO ZROBIL =====
       Ja                                SMB              BootPrompt
                                                             Kernel
                                                           m. Locales
                                                           m. DOS2Linux
       --------------------------------------------------------------------
       Piotr P.                         META              Instalation
                                       Serial              ISP-HookUp
                                       NET2               LargeDisk
                                       Ethernet
       --------------------------------------------------------------------
       Piotr T.                        XFree86,
                                         WWW
                                       Java-CGI
       --------------------------------------------------------------------
       Pawko O.                        Sound
                                      Modules

       ========== SPIS ==========
       Howtos:
       BootPrompt(*), BootDisk(*), Instalation(*), Kernel(*), Modules(*),
       Printing(-Usage), SCSI, SMB(*), Serial(*), Sound(*), UMSDOS, ISP-HookUp(*),
       META(*), NET2(*), Ethernet(*)

       Mini-Howtos:
       LILO, LargeDisk(*), Colour-ls, Consoles(-Many), DOS2LINUX(*), Getty-ps,
       KeySetup, Keystroke, Locales(*), Quota, Swap-Space, Upgrade, X*(*), Diald,

       (*) - oznacza zrobione, badz w trakcie tlumaczenia
       m. - mini HOWTO

  55..  PPrrzzeettuummaacczzoonnee ddookkuummeennttyy

  Aktualne informacje znajdziesz pod adresem www.jtz.org.pl/
  <http://www.jtz.org.pl/>.

  Pliki w formacie txt i html, nadajce si do drukowania s tutaj:
  ftp.jtz.org.pl:/JTZ/ <ftp://ftp.jtz.org.pl:/JTZ/>.
  Serwerem ftp zajmuje si PPiioottrr PPooggoorrzzeellsskkii i prosz kierowa wszelkie
  uwagi i komentarze ddoo nniieeggoo.

  66..  SSoowwnniikk

  Jeli znajdziesz jakie nowe sowo/wyraenie, ktre nadaje si do
  sownika, albo znajdziesz lepsze okrelene dla ktrego
  sowa/wyraenia ju bdcego w sowniku, to wylij je do
  B.Maruszewski@jtz.org.pl <mailto:B.Maruszewski@jtz.org.pl>.

    II ffoouunndd tthhaatt...... - przekonaem si

    aacckknnoowwlleeddggeemmeenntt - podzikowania (jako tytu sekcji), wyrazy uznania

    aaccttuuaall - rzeczywisty, ostateczny, faktyczny, biecy

    aaddaapptteerr - sterownik

    aaffffeecctt - dotyczy, mie negatywny wpyw na

    aaggggrreeggaattee wwoorrkkss - prace zebrane

    aarrrraannggeemmeenntt - ustawienie

    aassppeecctt rraattiioo - wspczynik ksztatu/obrazu

    bbaasseedd - oparty na

    bboooott - zaadowa, wystartowa system,

    bboooott ddiisskkeettttee - dyskietka startowa

    bboooott pprroommpptt - zachta startowa

    bbrrooaaddccaassttiinngg - rozgaszanie, nadawanie

    ccaann aacccceessss - ma dostp

    ccaarrrryy oouutt - wypenij, wykona, przeprowadzi

    cchhiipp - ukad scalony

    ccoommmmaanndd - polecenie

    ccoommmmaanndd oouuttppuutt - wynik/rezultat polecenia

    ((ttoo)) ccrraasshh - wywali si, zaamanie, pad/pa

    ccrreeddiittss - wyrazy uznania

    ddeebbuugg - odpluskwia

    ddeerriivvaattiivvee wwoorrkkss - prace pochodne

    ddiissaabbllee - wyczy

    ddiissccllaaiimmeerr - zastrzeenie

    ddrriivveerr - sterownik

    eennttrryy - pozycja

    EEPPRROOMM bbuurrnneerr - programator eprom-w

    eexxppiirree - wygasn

    ffeeeedd - zasila, zasilanie, dostarcza

    ffiigguurree oouutt - stwierdzi

    ffiilleessyysstteemm - system plikw

    fflleexxiibbiilliittyy - elastyczno

    ffoorr ddeettaaiillss - wicej na temat szczegw dotyczcych

    hhaacckk - przerobi (odnonie jdra Linux-a)

    hhaarrddwwaarree - sprzt

    hheeaaddeerr//iinncclluuddee ffiilleess - pliki nagwkowe

    iinntteerrffaaccee - interfejs

    iinnttrroodduuccttiioonn - wprowadzenie

    iissssuuee aa ccoommmmaanndd - wykona

    xxxxxx iissssuuee - sprawa dotyczca xxx

    jjuummppeerr - zworka, przecznik

    lleeaarrnn aabboouutt - naucz si, dowiedzie si o

    lliinnee - wiersz

    mmaaiinnttaaiinn - opiekowa si

    mmaaiinnttaaiinneedd - prowadzony/pielgnowany/utrzymywany przez

    mmaajjoorr - liczba gwna

    mmaann - podrcznik systemowy "man"

    mmaapp - odwzorowywa

    mmeemmoorryy wwiinnddooww - ramka pamici

    mmiinnoorr - liczba poboczna

    mmiirrrroorr - kopia

    nnoottee - zauwa, uwaga, zapamitaj

    oobbeeyy - podlega, by posusznym

    oovveerrrriiddee -- zmieni, nadpisa

    ppoollll - sprawdza, prbkowa, monitorowa

    pprroobbee - przeszukiwa, sprawdza, wykrywa, dokonywa detekcji

    pprroocceesssseedd - interpretowane, przetwarzane

    pprroommpptt - zachta

    ppuutt - umieci

    ttoo qquueerryy - pyta, sprawdza

    rreebboooott - przeadowanie

    rreefflleecctt - odzwierciedla

    rreelleeaassee - wersja, wydanie

    rroooott - administrator

    rroooott ffiilleessyysstteemm - gwny system plikw

    sshhaaddooww - przesania

    sshhaarree - wspdzieli

    sshheellll - powoka, interpreter

    sshheellll pprroommpptt - zachta powoki, interpretera

    ssooffttwwaarree - oprogramowanie

    ssppooooll ddiirreeccttoorryy - katalog zada, katalog buforowania

    ssuuppppoorrtt - obsugiwa

    ssyymmbboolliicc lliinnkk - doczenie/dowizanie/wskazanie symboliczne

    ssyysstteemm ccaallll - funkcja systemowa

    tteerrmmss ooff uussee - warunki stosowania/uywania/korzystania

    tthhiirrdd--ppaarrttyy bbooookkss - ksiki wydawnictw/autorw, nie zwizanych z
     firm produkujc opisywan rzecz<
     albo
     ksiki osb trzecich

    ttuunnee - ustawi, dostroi

    uunnlliikkee - w przeciwiestwie do, niopodobny do

    uuppggrraaddee - odnawianie, odswieanie, uaktualnianie

    uussaaggee - stosowanie

    uuttiilliittyy,, ttooooll - narzdzie

    wwoorrkk--aarroouunndd - obejcie
     zamiast "(w)yedytowa" uyj raczej "(z)modyfikowa"

     ===========================================================

     Wyrazy ktrych nie tumaczymy:

     firewall, bridge, host, proxy, log, stdin, stdout, locale, *roff, timeout

     mieszcz si tutaj take wszelkie polecenia systemowe i nazwy programw
     X, emacs, *TeX, *script.
     ===========================================================

     Jak odmienia wyrazy nietumaczone, zaczerpnite z j. angielskiego oraz
     wszelkie skrty?

     Wyrazy zaczerpnite z ang. to takie jak: Linux, Unix, fax...

     Jeli wyraz koczy si na spgosk, to dodajemy <bf/mylnik/ i piszemy
     kocwk polsk wg. rodzaju jaki dany wyraz przyjmuje w j. polskim:<newline>
     np: ten firewall -- tego firewall-a<newline>
         ten RAM -- tego RAM-u<newline>
     W dopeniaczu (kogo? czego?) skrtu koczcego si na spgosk zawsze
     uywamy kocwki -u: DOS-u, BIOS-u itd.

     Jeli wyraz koczy si na samogosk, to dodajemy <bf/apostrof/ i piszemy
     kocwk polsk wg. rodzaju jaki dany wyraz przyjmuje w j. polskim:<newline>
     np: ten bridge - tego bridge'a

     <bf/Do skrtw/ zawsze stosujemy mylnik.<newline>
     <bf/W imionach/ oczywicie nie stosujemy mylnika.

     Jeli wyraz koczy si na tzw. nieme "e", to lepiej unika jego
     odmiany, np: edytor joe -- w edytorze joe, edytora joe. A nie edytorze
     joe'u czy edytora joe'a ...

  77..  JJaakk kkoorrzzyyssttaa zz ttrryybbuu ppssggmmll ppoodd XXeemmaaccsseemm??

  Cakiem prosto:

    zainstalowa pakiet linuxdoc-sgml

    dopisa do pliku .bashrc wiersze

       LINUXDOCLIB=/usr/lib/linuxdoc-sgml
       export LINUXDOCLIB
       SGML_PATH=$LINUXDOCLIB/dtd/%N.dtd:$LINUXDOCLIB/dtd/%P.dtd:$LINUXDOCLIB/rep/html/%N
       export SGML_PATH

    uruchomi xemacs-a i pisa!

     Ha, wydaje mi si, e to wczoraj w domu zadziaao (RH4.1,
     xemacs-19.16 i linuxdoc-sgml-costam-rpm) jak wrce to sprawdz.
     Niestety w pracy po zainstalowaniu najnowszych sgml-tools-0.99.4
     nie chce dziaa z trybem psgml - przychodzi z wasnym plikiem
     contrib/sgml-mode.el, ktry nie jest tak bogaty jak psgml.

  88..  TTrroocchh ddaannyycchh tteecchhiicczznnyycchh ddllaa ttuummaacczzyy..

  [Sekcja napisana przez Bartka Maruszewskiego.]
  Wczeniej ju zostao wspomniane, e piszemy w formacie SGML. Format
  ten bardzo przypomina HTML wic jeli znasz ten ostatni, to nie
  powinien on ci nastrcza wikszych trudnoci. Narzdzia do obsugi
  tego formatu to pakiet _s_g_m_l_-_t_o_o_l_s.

  88..11..  KKrrttkkii mmiinniikkuurrss SSGGMMLL--aa..

  Wielu z was chce si przyczy, ale pisze do mnie, e nie zna SGML-a.
  No i pisz do kadego litani wszystkich zasad itp. eby tego nie
  robi postanowiem zamieci kilka porad jak z niego korzysta.

    Przede wszystkim chciabym zauway, e SGML jest podobny do HTML-a
     jeli chodzi o skadni - mona waciwie powiedzie, e jest taka
     sama. Np.: w HTML-u piszesz <I> a w SGML-u <it>, w HTML-u <B> - w
     SGML-u <bf> (wielko liter oczywicie nie ma znaczenia).

    W SGML-u, tak samo jak w HTML-u, s pewne znaczki o znaczeniu
     specjalnym. S to np.: &, <, >, ~ itp. eby je zapisa naley uy
     specjalnej notacji. I tak odpowiednio s to: &amp;, &lt;, &gt;,
     &tilde;. Zobacz punkt 3.2 w podrczniku w katalogu
     /usr/doc/sgmltools-xxx.

    Najprostszym sposobem na zorientowanie si jak powinien wyglda
     plik rdowy w SGML-u jest zajrzenie, do ktrego z ju napisanych
     dokumentw.  Oglnie metoda jest prosta:
     - bierzesz nagwek podany w drugim punkcie tego dokumentu i
     kopiujesz go do swojego tumaczenia.
     - dalej wszystko tak samo jak w innych dokumentach SGML.

    Jeszcze jedna wana uwaga, ktra przysparza troch kopotw. Jeli
     stosujesz tag-i i w rodku uyjesz znak /, to parser potraktuje, to
     jako koniec tag-u.  Wic jeli zamierzasz uy / w rodku tag-u, to
     stosuj je w penej postaci, czyli np. <bf>tekst</bf>. Pisz to, bo
     mona te stosowa skrtow form: <bf/tekst/.

  To naprawd nie jest trudne.

  Teraz troch o konwersji.

  Do konwersji pliku rdowego SGML-a na HTML i TXT su odpowiednio
  programy _s_g_m_l_2_h_t_m_l i _s_g_m_l_2_t_x_t. Wszystko co musisz pamita, to uycie
  odpowiedniej opcji dla _s_g_m_l_2_t_x_t, eby zostawi polskie znaki w
  spokoju. Opcja ta to --ll. Podczas konwersji wystpuje z reguy bd
  _C_o_u_l_d_n_'_t _f_i_n_d _f_o_n_t _'_C_' czy jako tak - ot nie ma si czym
  przejmowa. Poprawny dokument tekstowy zostanie wygenerowany.

  Co do konwersji na HTML, to tutaj problemu z polskimi literami nie ma,
  ale trzeba pamita, aby uy opcji --LL ppoolliisshh, eby odwoania _N_e_x_t,
  _T_a_b_l_e _o_f _C_o_n_t_e_n_t_s i _P_r_e_v_i_o_u_s zamieni na polskie odpowiedniki. Przed
  konwersj za plik /usr/lib/linuxdoc-sgml/rep/html/polish i wpisz w
  nim:

  PrevPage: Poprzednia
  NextPage: Nastpna
  TOC: Spis&nbsp;Treci

  Narzdzia SGML, s dostpne pod adresem pobox.com
  <http://pobox.com/~cg/sgmltools/>.

  Hmmm... wydaje mi si, e to wszystko. Jak sobie o czym przypomn to
  dopisz.

  99..  CCoo mmaamm zzrroobbii jjeellii cchhcc ppoopprraawwii ddookkuummeenntt..

  Po pierwsze wszelkie poprawki trzeba nanosi w formacie SGML.

  Jeli znalaze literwki, to po prostu popraw je i wylij poprawion
  wersj do tumacza. Upewnij si przedtem czy masz najnowsz wersj, bo
  moe bdy, ktre poprawiasz s ju poprawione w nowszej wersji.

  Jeli chcesz ingerowa w tre dokumentu, to najprociej jeli
  zachowasz kopi tumaczenia, naniesiesz poprawki, ktre uwaasz za
  stosowne i potem wydasz polecenie "_d_i_f_f _-_N_u _s_t_a_r_a_-_w_e_r_s_j_a _n_o_w_a_-_w_e_r_s_j_a _>
  _z_m_i_a_n_y" i wylesz zawarto pliku zmiany do tumacza.

  1100..  KKoonnwweerrssjjaa SSGGMMLL -->> LLaaTTeeXX aa sspprraawwaa ppoollsskkaa

  Autor sekcji: MMiicchhaa MMaallaarrsskkii malarz@it.pw.edu.pl

  _W _p_o_n_i__s_z_y_m _t_e_k_s_c_i_e _o_p_i_s_u_j_ _m_o_j_e _u_d_a_n_e _p_r__b_y _k_o_n_w_e_r_s_j_i _d_o_k_u_m_e_n_t_u _z
  _p_o_l_s_k_i_m_i _z_n_a_k_a_m_i _d_i_a_k_t_r_y_c_z_n_y_m_i _z_a_p_i_s_a_n_e_g_o _w _f_o_r_m_a_c_i_e _S_G_M_L _n_a _f_o_r_m_a_t
  _L_a_T_e_X _o_r_a_z _D_V_I _(_D_e_v_i_c_e _I_n_d_e_p_e_n_d_e_n_t_) _i _P_S _(_P_o_s_t_S_c_r_i_p_t_)_.

  1100..11..  LLaaTTeeXX ii LLaaTTeeXX22ee ((eeppssiilloonn))

  Bezproblemowo znaki rnych alfabetw moemy uywa tylko w nowym
  formacie LaTeX-a (tzw. LaTeX-u 2e), standardowo pozwalajcym na
  pisanie z ogonkami.  Aby mona byo uywa jawnie polskich liter w
  LaTeX-u w nagwku dokumentu w formacie LaTeX wygenerowanego przez
  program sgml2latex musz wystpi nastpujce linie:

  ______________________________________________________________________
          \usepackage{t1enc}
          \usepackage[latin2]{inputenc}
          \usepackage[polish]{babel}
  ______________________________________________________________________

  Najwaniejsza jest pierwsza z nich:

  ______________________________________________________________________
          \usepackage{t1enc}
  ______________________________________________________________________

  Linia ta umoliwia w ogle pisanie z ogonkami.

  Kolejna linia:

  ______________________________________________________________________
          \usepackage[latin2]{inputenc}
  ______________________________________________________________________

  umoliwia zapisanie polskich liter w standardzie ISO Latin 2 (ISO
  8859-2) a nie jakimi przedziwnymi zaklciami magicznymi LaTeX-a.

  Trzecia z nich, a mianowicie:

  ______________________________________________________________________
          \usepackage[polish]{babel}
  ______________________________________________________________________

  daje nam jedynie dodakowy bajer: sowa w jzyku polskim w razie
  potrzeby zostan poprawnie podzielone (zgodnie z reguami jzyka
  polskiego oczywicie).

  Niestety program sgml2latex, generujcy za kadym razem najpierw plik
  w formacie LaTeX, a dopiero pniej korzystajc z tego pliku generuje
  pliki w formatach DVI i/lub PS, nie generuje odpowiednich linii w tym
  pliku.

  1100..22..  CCoo nnaamm ggeenneerruujjee ssggmmll22llaatteexx ??

  Program sgml2latex umoliwia wygenerowanie pliku w formacie LaTeX lub
  LaTeX2e (z opcj -2e).  Wszystko byoby fajnie gdyby ten plik by
  poprawny dla nas (czyli zawiera linie wymienione powyej).  Niesety
  tak nie jest. eby to poprawi wystarczy jedynie troch zmodyfikowa
  plik

  /usr/lib/linuxdoc-sgml/rep/latex2e/mapping

  w ktrym jest opisany sposb konwersji pliku SGML do formatu LaTeX2e.
  W pliku tym we fragmencie dotyczcym konwersji tag-u <article> zamiast
  linii

  ______________________________________________________________________
          "\\usepackage\[latin1\]{inputenc}\n"
  ______________________________________________________________________

  naley wstawi trzy nastpujce linie:

  ______________________________________________________________________
          "\\usepackage{t1enc}\n"
          "\\usepackage\[latin2\]{inputenc}\n"
          "\\usepackage\[polish\]{babel}\n"
  ______________________________________________________________________

  Pierwsze dwie z tych linii musz znale si koniecznie, natomiast
  trzecia wedle upodobania.  Musz jednak doda, e w wypadku dodania
  trzeciej z tych linii konieczne jest odpowiednie skonfigurowanie
  programu dvips (przynajmniej ja to zrobiem, w kadym razie
  korzystajc z programu texconfig dodaem polski sposb dzielenia
  wyrazw.

  Jeeli korzystajc z formatu SGML tworzymy takze inne dokumenty mona
  w taki sam sposb dokona zmian w sekcjach dotyczcych konwersji
  tag-w <report>, <book> oraz <notes>. Te zmiany nie s jednak
  konieczne gdy pracujemy wycznie z dokumentami HOWTO.

  1100..33..  PPrrooggrraamm ssggmmll22llaatteexx ii pplliikkii DDVVII oorraazz PPSS

  Ju mamy poprawne generowanie plikw w formacie LaTeX2e. Teraz jeszcze
  musimy posiada LaTeX-a w wersji 2e. Jeeli mamy zainstalowany pakiet
  tetex (chyba jeden z popularniejszych w dystrybucjach linux-a) to mamy
  odpowiedni program. Poniewa program sgml2latex oczekuje, e program
  LaTeX2e wywoujemy przez latex2e to musimy mu taki sposb wywoania
  tego programu zapewni. Najprociej jest w katalogu /usr/bin utworzy
  skrt o nazwie latex2e do programu latex, czyli:

  ______________________________________________________________________
  cd /usr/bin
  ln -s latex latex2e
  ______________________________________________________________________

  1100..44..  KKoonnwweerrssjjaa wwaacciiwwaa,, cczzyyllii jjaakk uuzzyysskkaa DDVVII lluubb PPSS

  Po dokonaniu wyej wymienionych modyfikacji adne zmiany w dokumentzch
  SGML nie s ju konieczne. Wystarcz jedynie odpowiednie opcje
  programu sgml2html. Naley pamita o uyciu opcji -2e aby program
  generowa pliki w formacie LaTeX2e a nie w starszym (LaTeX).

  Aby uzyska wersj w formacie DVI uywamy komendy:

  sgml2latex -2e -a -d nasz_plik.sgml

  Analogicznie moemy wygenerowa pliki w formacie PS:

  sgml2latex -2e -a -p nasz_plik.sgml

  1100..55..  UUwwaaggii

  Rozwizanie jest w paru miejscach troch toporne, ale skuteczne.
  Osobicie byy to moje pierwsze kroki w LaTeX-u, wic opis do
  czynnoci, ktre naley wykona moe by troch nieodpowiedni.
  Wszelkie informacje o LaTeX-u jakie potrzebowaem do uzyskania
  satysfakcjonujcych mnie wynikw uzyskaem z Polskiej Strony Ogonkowej
  oraz od Jakuba Gsiorowskiego, mojego kumpla ze studiw.

  Wszelkie uwagi, usprawnienia rozwizania oczywicie bd bardzo mile
  widziane.

