JJak tto zzrobić (JTZ) czyli HOWTO po polsku Bartosz Maruszewski B.Maruszewski@jtz.org.pl MichaÅ‚ Malarski malarz@it.pw.edu.pl Piotr Pogorzelski piotr.pogorzelski@ippt.gov.pl v 3.8, 28 Grudnia 2003 Informacje co to takiego JTZ, skÄ…d siÄ™ to wzięło, czemu to ma sÅ‚użyć, komu to jest potrzebne, a komu nie. Najnowsza wersja tego dokumentu znajduje siÄ™ na naszym serwerze FTP ftp.jtz.org.pl oraz na Polskiej Stronie TÅ‚umaczeÅ„ . ChciaÅ‚bym zauważyć, że dokument ten dość czÄ™sto siÄ™ zmienia, wiÄ™c pilnuj proszÄ™ czy masz najnowszÄ… wersjÄ™. Szczególnie zwracam uwagÄ™ na sÅ‚owniczek. ______________________________________________________________________ Spis treÅ›ci 1. Projekt JTZ 1.1 Co to jest JTZ ? 1.2 Jak zacząć? 1.3 Ustalenia, które staÅ‚y siÄ™ obowiÄ…zujÄ…cym prawem. 1.4 Lista dyskysyjna i CVS 1.4.1 Lista dyskusyjna 1.4.2 CVS 1.5 Pierwsze rezultaty 1.6 PrzetÅ‚umaczone dokumenty 1.7 Co zrobić, jeÅ›li chcÄ™ poprawić czyjeÅ› tÅ‚umaczenie? 2. SÅ‚ownik 3. Format tÅ‚umaczonych dokumentów: SGML 3.1 Docbook 3.1.1 Informacje o tÅ‚umaczu 3.1.2 WiÄ™cej nt. docbook 3.2 Linuxdoc 3.2.1 Informacje o tÅ‚umaczu 3.3 Krótki minikurs SGML-a. 3.4 Teraz trochÄ™ o konwersji. 3.4.1 Polonizacja pakietu 4. Technikalia - historia (dot. linuxdoc) 4.1 Jak korzystać z trybu psgml pod Xemacsem? 4.2 konwersja txt i html a sprawa polska 4.3 Konwersja SGML -> LaTeX a sprawa polska 4.3.1 LaTeX i LaTeX2e (epsilon) 4.3.2 Co nam generuje sgml2latex ? 4.3.3 Program sgml2latex i pliki DVI oraz PS 4.3.4 Konwersja wÅ‚aÅ›ciwa, czyli jak uzyskać DVI lub PS 4.3.5 Uwagi 5. Od autorów ______________________________________________________________________ 11.. PPrroojjeekktt JJTTZZ 11..11.. CCoo ttoo jjeesstt JJTTZZ ?? Wszystko zaczęło siÄ™ od tego, że kilku osobom chciaÅ‚o siÄ™ poÅ›wiÄ™cić trochÄ™ czasu (bynajmniej nie wolnego) (choć jeden z nich sugerowaÅ‚, że podobno miaÅ‚ mieć jakieÅ› ferie, czy coÅ› w tym stylu, lecz przecież każdy rozsÄ…dny czÅ‚owiek wie, że nie ma czegoÅ› takiego jak ferie, urlop, wolna chwila. To sÄ… puste pojÄ™cia wymyÅ›lone przez *owców, które majÄ… jedynie namÄ…cić ludziom w gÅ‚owach) i wspomóc World Linux Domination Project Polska (choć część z nich na pewno sobie nie zdawaÅ‚a sprawy z tego co robi) tÅ‚umaczÄ…c HOWTO na nasz rodzimy jÄ™zyk. Dosyć szybko zebraÅ‚a siÄ™ maÅ‚a grupka ludzi, którzy rzuciwszy w kÄ…t inne sprawy zabrali siÄ™ do dyskusji co przetÅ‚umaczyć, jak to przetÅ‚umaczyć i co z tymi tÅ‚umaczeniami robić. Na szczęście nie byli w tym najlepsi (w tÅ‚umaczeniach też nie, jak sami zobaczycie), wiÄ™c siÄ™ zajÄ™li innym sprawami (wesela, kino, spacer itp.). Ku ogólnemu zdziwieniu okazaÅ‚o siÄ™, że ich wysiÅ‚ek nie poszedÅ‚ na marne i zaczęły pojawiać siÄ™ pierwsze efekty ich dziaÅ‚aÅ„ (o nich za chwilÄ™). Również ich dyskusje, zaowocowaÅ‚y pewnymi ustaleniami, które od tej pory staÅ‚y siÄ™ obowiÄ…zujÄ…cym prawem. OOssoobbÄ…Ä… kkoooorrddyynnuujjÄ…Ä…ccÄ…Ä… projekt jest BBaarrttoosszz MMaarruusszzeewwsskkii B.Maruszewski@jtz.org.pl 11..22.. JJaakk zzaacczzÄ…ąćć?? Najpierw należy wybrać co chcesz tÅ‚umaczyć. Zajrzyj na adres http://cvs.jtz.org.pl/JTZ/tools/howto.dat i sprawdź czy ktoÅ› już nie przetÅ‚umaczyÅ‚ lub nie tÅ‚umaczy aktualnie tego samego. JeÅ›li tak, to możesz siÄ™ z nim skontaktować w sprawie pomocy lub wybrać coÅ› innego. JeÅ›li wybranego HOWTO nie ma na liÅ›cie tÅ‚umaczonych ani dostÄ™pnych, to znaczy, że nic o tym dokumencie nie wiemy i możesz go Å›miaÅ‚o tÅ‚umaczyć. NastÄ™pnie, po wybraniu materiaÅ‚u do pracy, należy poinformować nas, że zabierasz siÄ™ za tÅ‚umaczenie. Najlepiej jeÅ›li uzyskasz dostÄ™p do CVS (patrz punkt _L_i_s_t_a _d_y_s_k_u_s_y_j_n_a _i _C_V_S) i dopiszesz do pliku tools/howto.dat informacje o swojej pracy. Możesz też zrobić to przez listÄ™ dyskusyjnÄ… (patrz punkt _L_i_s_t_a _d_y_s_k_u_s_y_j_n_a _i _C_V_S). Później postÄ™puj zgodnie z _u_s_t_a_l_e_n_i_a_m_i. UUwwaaggaa!!!!!! Bardzo ważne jest poinformowanie nas o zamiarze tÅ‚umaczenia. JeÅ›li nie powiesz nam o tym, to inni chÄ™tni nie bÄ™dÄ… wiedzieć, że dany tekst jest już tÅ‚umaczony i mogÄ… zabrać siÄ™ za to samo. 11..33.. UUssttaalleenniiaa,, kkttóórree ssttaaÅ‚Å‚yy ssiięę oobboowwiiÄ…Ä…zzuujjÄ…Ä…ccyymm pprraawweemm.. Te ogniste dyskusje, o których wczeÅ›niej pisaÅ‚em (wymiana kilkunastu listów miÄ™dzy trzema osobami) doprowadziÅ‚y do przyjÄ™cia nastÄ™pujÄ…cych zasad: · Upewnij siÄ™, że posiadasz najnowszÄ… wersjÄ™ dokumentu (po co siÄ™ mÄ™czyć dwa razy?) i sprawdź czy autor nie ma jakichÅ› zastrzeżeÅ„ co do tÅ‚umaczenia. ZZaawwsszzee informuj autora, że chcesz przetÅ‚umaczyć jego dokument. Możesz zacząć tÅ‚umaczyć od razu po wysÅ‚aniu listu, nie czekajÄ…c na odpowiedź, bo szansa, że autor siÄ™ nie zgodzi jest raczej jak 1:1 000 000 :) Dokumenty zawarte w LLinux DDocumentation PProject sÄ… udostÄ™pniane na licencji GNU GPL wiÄ™c można je tÅ‚umaczyć bez wyraźnego pozwolenia. W takim przypadku wypada jednak poinformować autora o tÅ‚umaczeniu chociażby po to, żeby wiedziaÅ‚, że takie istnieje i żeby mógÅ‚ zawrzeć informacje o nim w kolejnej wersji. · JeÅ›li jest dostÄ™pna wersja oryginaÅ‚u w sgml, to tÅ‚umacz jÄ…. · WW ttÅ‚Å‚uummaacczzeenniiaacchh wwyykkoorrzzyyssttuujjeemmyy oopprraaccoowwaannyy wwssppóóllnniiee ssÅ‚Å‚oowwnniikk, starajÄ…c siÄ™ zachować wspólne sÅ‚ownictwo (niestety trzeba zrezygnować z ulubionych zwrotów). SÅ‚ownik taki znajduje siÄ™ w repozytorium CVS pod adresem cvs.jtz.org.pl/JTZ/tools/slowniczek. Zapoznaj siÄ™ z nim przed rozpoczÄ™ciem tÅ‚umaczenia - uchroni ciÄ™ to od niepotrzebnych, dÅ‚ugotrwaÅ‚ych poprawek. SÅ‚ownik ten znajduje siÄ™ także w tym dokumencie. Zawarte w nim sÅ‚ownictow jest jedynym sÅ‚usznym i proszÄ™ siÄ™ go trzymać. ChciaÅ‚bym utrzymać jednolitość tÅ‚umaczeÅ„. · KKaażżddyy nnaaggÅ‚łóówweekk ddookkuummeennttuu mmaa wwyyggllÄ…Ä…ddaaćć ttaakk ssaammoo: zawierać dane o autorze, tÅ‚umaczu i wersji danego HOWTO. DokÅ‚adna skÅ‚adnia tego nagłówka zależy od definicji dokumentu (lliinnuuxxddoocc lub ddooccbbooookk) i podana jest w rozdziale ``Format tÅ‚umaczonych dokumentów: sgml''. Skopiuj jÄ… stamtÄ…d do tÅ‚umaczonego dokumentu i uzupeÅ‚nij swoimi danymi. W razie wÄ…tpliwoÅ›ci obejrzyj nagłówki istniejÄ…cych już tÅ‚umaczeÅ„. Po nagłówku dopisujesz jeszcze sekcjÄ™ . JeÅ›li takowa już jest to tylko do niej dopisz: ___________________________________________________________________ Dokument ten zostaÅ‚ napisany w standardzie ISO-8859-2. OryginaÅ‚ tego dokumentu znajduje siÄ™ pod adresem... jeÅ›li autor nie podaÅ‚, to podaj ftp.icm.edu.pl/pub/Linux/sunsite/docs/HOWTO/(mini) ___________________________________________________________________ · Wszystkie teksty piszemy w formacie SGML. JeÅ›li tÅ‚umaczysz HOWTO i nie ma jego wersji SGML, to stwórz jÄ… podczas tÅ‚umaczenia. W rozdziale _F_o_r_m_a_t _t_Å‚_u_m_a_c_z_o_n_y_c_h _d_o_k_u_m_e_n_t_ó_w_: _S_G_M_L znajdziesz mini wstÄ™p do SGMLa. Dokumentów HOWTO nie przyjmujemy w innej postaci, ponieważ LDP i pochodny JTZ sÄ… zwartÄ… caÅ‚oÅ›ciÄ…, która ma wyglÄ…dać oraz dlatego, że Å‚atwo jest tworzyć inne formaty z SGMLa. JeÅ›li tÅ‚umaczony tekst nie jest dokumentem HOWTO, to zastanów siÄ™ jednak czy nie napisać w SGMLu. Polskie litery kodujemy w jjeeddyynnyymm aktualnym standardzie (dla nieuÅ›wiadomionych dodam, że nazywa siÄ™ on ISO-8859-2). WiÄ™cej informacji odnoÅ›nie standardu kodowania można znależć na Polskiej Stronie Ogonkowej · Zajmujemy siÄ™ tylko tÅ‚umaczeniem, choć bardzo byÅ›my chcieli nie możemy jednoczeÅ›nie aktualizować tÅ‚umaczonych dokumentów. Aktualizować oznacza, że nie możemy weryfikować danych znajdujÄ…cych siÄ™ w oryginale. JeÅ›li oryginaÅ‚ zostanie zaktualizowany, to każdy tÅ‚umacz jest zobowiÄ…zany do uaktualnienia swojego tÅ‚umaczenia. OczywiÅ›cie jeÅ›li tÅ‚umacz ma taki kaprys/czas/ochotÄ™, to ma peÅ‚ne prawo weryfikować dane zawarte w oryginale aczkolwiek wymagamy, aby takie zmiany zostaÅ‚y wwyyrraaźźnniiee zaznaczone. · Każdy dokument musi zawierać rozdziaÅ‚, w którym podane sÄ… wszelkie wprowadzone zmiany w stosunku do oryginaÅ‚u. Najlepiej na koÅ„cu zatytuowany OOdd ttÅ‚Å‚uummaacczzaa. · GÅ‚ownym celem JTZ jest tÅ‚umaczenie dokumentów HOWTO. Jednak przyjmujemy także do naszych zasobów (WWW, FTP, CVS) tÅ‚umaczenia innych dokumentów. Warto gromadzić różne tÅ‚umaczenia w jednym miejscu. · Nazw plików nie tÅ‚umaczymy, Installation-HOWTO pozostanie dalej Installation-HOWTO. Dodajemy jedynie rozszerzenie ..ppll..ssggmmll. · Oprócz numeracji oryginaÅ‚u stosujemy także numeracjÄ™ tÅ‚umaczenia. Patrz kilka punktów wyżej na temat nagłówka pliku sgml. Numeracja ta jest niezależna od numeracji oryginaÅ‚u i zawsze zaczynamy od wersji 1.0 · JeÅ›li zmieniasz wersjÄ™ tÅ‚umaczenia, to zastosuj siÄ™ do poniższych reguÅ‚: · JeÅ›li sÄ… to duże poprawki/zmiany, np.: przeróbka kilku sekcji, likwidacja niektórych, dodanie nowych, to zmieÅ„ wersjÄ™ głównÄ… ((11..00 -->> 22..00)) · JeÅ›li sÄ… to Å›rednie poprawki/zmiany, np.: poprawka wiÄ™kszej iloÅ›ci bÅ‚Ä™dów zmiana kilku adresów, to zmieÅ„ wersjÄ™ pobocznÄ… ((11..00 -->> 11..11)) · JeÅ›li sÄ… to maÅ‚e poprawki/zmiany, np.: usuniÄ™cie paru literówek, zmiana jednego/dwóch adresów, to zmieÅ„ drugÄ… cyfrÄ™ po przecinku ((11..00 -->> 11..0011)) BÄ™dzie to uÅ‚atwienie dla użytkowników, którzy bÄ™dÄ… wiedzieć czy opÅ‚aca siÄ™ Å›ciÄ…gać nowÄ… wersjÄ™ czy nie. · JeÅ›li w dokumencie znajduje siÄ™ odwoÅ‚anie do przetÅ‚umaczonego już HOWTO, to zrób odwoÅ‚anie do tego tÅ‚umaczenia a nie oryginaÅ‚u. TÅ‚umaczenia 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 · W zwiÄ…zku z powyższym punktem bbaarrddzzoo pprroosszzęę wszystkich tÅ‚umaczy, aby stosowali siÄ™ do powyższego szablonu. · Pytacie czasami czy możecie wstawiać wÅ‚asne tagi ( itd.). Otóż żadnych zasad na ten temat nie wypracowaliÅ›my. Ja (Bartek) tÅ‚umaczÄ™ dokument tak jak jest i nie upiÄ™kszam go, bo nie mam czasu i mi siÄ™ nie chce. Wg mnie jeÅ›li chcesz sie pobawić -- proszÄ™ bardzo. · Zastanawiacie siÄ™ także, czy można używać "mniej oficjalnych" słów. Otóż wg mnie takie HOWTO jest pisane przez ludzi i dla ludzi i nie jest to żadne rzÄ…dowe pismo super oficjalne itp. Już nie raz widziaÅ‚em taki slang, że po kilkukrotnym przeczytaniu nie wiedziaÅ‚em o co chodzi... Jednak należy pamiÄ™tać o pewnym umiarze... nie przesadzajmy :) · ZdarzajÄ… sie czasami takie wyrażenia, które ciężko przetÅ‚umaczyć na polski i wychodzÄ… z tego jakieÅ› dziwolÄ…gi jÄ™zykowe albo w ogóle nie majÄ… odpowiednika w j. polskim. W takim przypadku przetÅ‚umacz to, ale podaj dodatkowo w nawiasie wersjÄ™ oryginalnÄ… wyrażenia. Stosuj takie rozwiÄ…zanie także jeÅ›li tÅ‚umaczenie jest dwuznaczne. · Jak już przetÅ‚umaczysz, sprawdzisz i stwierdzisz, że można tÅ‚umaczenie oddać do użytku, to przedtem sprawdź, czy dokument poprawnie konwertuje siÄ™ na inne formaty. W rozdziale _F_o_r_m_a_t _t_Å‚_u_m_a_c_z_o_n_y_c_h _d_o_k_u_m_e_n_t_ó_w_: _S_G_M_L jest punkt poÅ›wiÄ™cony temu tematowi. · Po przetÅ‚umaczeniu i sprawdzeniu powyższego umieszczasz ostatecznÄ… wersjÄ™ tÅ‚umaczenia w CVS i oznaczasz jÄ… etykietÄ… (tagiem) ??. To spowoduje, że dokument znajdzie siÄ™ na WWW i FTP w różnych formatach. 11..44.. LLiissttaa ddyysskkyyssyyjjnnaa ii CCVVSS 11..44..11.. LLiissttaa ddyysskkuussyyjjnnaa JeÅ›li chcesz do nas doÅ‚Ä…czyć zapisz siÄ™ na naszÄ… listÄ™, lecz pamiÄ™taj, że jest ona przeznaczona, dla osób pprraaccuujjÄ…Ä…ccyycchh nad tÅ‚umaczeniami, nie sÅ‚uży do przyglÄ…dania siÄ™, jak postÄ™pujÄ… prace. Adres listy to _j_t_z_@_w_l_u_g_._i_s_t_s_._p_w_r_._w_r_o_c_._p_l. Aby siÄ™ na niÄ… zapisać wyÅ›lij na adres jtz- request@wlug.ists.pwr.wroc.pl list zawierajÄ…cy w treÅ›ci lub tytule sÅ‚owo subscribe JJeeddyynnyy ssÅ‚Å‚uusszznnyy adres listy dyskusyjnej, na który należy pisać, to _j_t_z_@_w_l_u_g_._i_s_t_s_._p_w_r_._w_r_o_c_._p_l. Poprawnymi adresami, zz kkttóórryycchh mogÄ… przychodzić listy, to _j_t_z_@_d_i_a_m_e_n_t_._i_s_t_s_._p_w_r_._w_r_o_c_._p_l lub _j_t_z_@_j_t_z_._o_r_g_._p_l, ale na te adresy proszÄ™ nie wysyÅ‚ać listów, bo mogÄ… niezauważone siÄ™ zmienić. 11..44..22.. CCVVSS AAllee jjaakkii CCVVSS???? CCoo ttoo ii ppoo ccoo???? Projekt JTZ przechowuje swoje zasoby w repozytorium _C_V_S. Jest to jedyne sÅ‚uszne miejsce, gdzie znajdujÄ… siÄ™ wszelkie dokumenty zarówno w trakcie opracowywania jak i dopuszczone już do wydania. CVS jest to system zarzÄ…dzania zasobami tekstowymi dla wielu użytkowników, w skÅ‚ad którego wchodzi: · miejsce na serwerze · kontrola wersji plików · kontrola konfliktów miÄ™dzy różnymi wersjami stworzonymi przez różne osoby · itp Najważniejsze, co musisz wiedzieć, to fakt, że projekt JTZ korzysta z CVS. JeÅ›li zamierzasz przetÅ‚umaczyć jeden tekst i o nim zapomnieć lub nie jesteÅ› hakerem i boisz siÄ™ nowoÅ›ci, to skontaktuj siÄ™ z nami poprzez listÄ™ dyskusyjnÄ… przed rozpoczÄ™ciem tÅ‚umaczenia. Od razu napiszÄ™, że w taki sposób najprawdopodobniej procedura bÄ™dzie kilkakrotnie wydÅ‚użona, gdyż wymagana jest kilkukrotna interwencja innej osoby poza TobÄ…. JeÅ›li zamierzasz być programistÄ… i pracować w wiÄ™kszej grupie osób, to radzÄ™ siÄ™ zapoznać z CVS. DostÄ™p do zasobów CVS (tylko do odczytu) jest możliwy także poprzez WWW pod adresem cvs.jtz.org.pl/JTZ/ . Aby uzyskać prawo zapisu do CVS JTZ należy najpierw zgÅ‚osić siÄ™ na listÄ™ dyskusyjnÄ…, a nastÄ™pnie wysÅ‚ać na adres Tomasza KÅ‚oczko list zawierajÄ…cy nastÄ™pujÄ…ce informacje: · uzasadnienie (należy napisać, że chodzi o prace nad moduÅ‚em JTZ) · e-adres kontaktowy, · imiÄ™ i nazwisko, · to co zwróci polecenie w Linuksie/uniksie: $ echo -n ":"; perl -e 'print crypt "",""; print "\n";' to dwie dowolne literki. i - to można siÄ™ domyÅ›lić: wybrany identyfikator i hasÅ‚o do niego. UUwwaaggaa:: Na adres _k_l_o_c_z_e_k_@_r_u_d_y_._m_i_f_._p_g_._g_d_a_._p_l należy wysyÅ‚ać tylko powyższe informacje. Wszelkie inne informacje/zapytania należy wysyÅ‚ać na adres listy -- _j_t_z_@_w_l_u_g_._i_s_t_s_._p_w_r_._w_r_o_c_._p_l. Aby móc pisać na listÄ™ należy siÄ™ najpierw na niÄ… zapisać! Patrz podpunkt _L_i_s_t_a _d_y_s_k_u_s_y_j_n_a tego rozdziaÅ‚u. 11..55.. PPiieerrwwsszzee rreezzuullttaattyy PostanowiliÅ›my, że przetÅ‚umaczone dokumenty bÄ™dÄ… udostÄ™pniane szerszemu gronu dopiero, kiedy bÄ™dÄ… siÄ™ do tego nadawaÅ‚y ;-). To znaczy, że przetÅ‚umaczony dokument musi trochÄ™ poczekać, zostać ponownie sprawdzony przez autora i dopiero potem może pokazać siÄ™ szerszej publicznoÅ›ci. Dotyczy to _s_z_e_r_s_z_e_g_o _g_r_o_n_a czyli WWW i FTP. W zasobach CVS majÄ… prawo przebywać niepeÅ‚ne tÅ‚umaczenia, nad którymi trwajÄ… prace -- po to jest CVS; korzystajcie z niego. JeÅ›li chcesz wiedzieć nad czym w tej chwili pracujemy, zajrzyj na stronÄ™ cvs.jtz.org.pl/JTZ/tools/howto.dat . Tam powinny znajdować siÄ™ mniej wiÄ™cej taka treść: ______________________________________________________________________ ========== KTO ========== ===== CO ROBI ===== ===== CO ZROBIL ===== Bartek M. 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 ______________________________________________________________________ 11..66.. PPrrzzeettÅ‚Å‚uummaacczzoonnee ddookkuummeennttyy Aktualne informacje znajdziesz na Polskiej Stronie TÅ‚umaczeÅ„ . Wszystkie przetÅ‚umaczone dokumenty (w różnych formatach) można znaleźć na naszym serwerze FTP 11..77.. CCoo zzrroobbiićć,, jjeeśśllii cchhccęę ppoopprraawwiićć cczzyyjjeeśś ttÅ‚Å‚uummaacczzeenniiee?? Po pierwsze wszelkie poprawki trzeba nanosić w formacie SGML. JeÅ›li znalazÅ‚eÅ› literówki, to po prostu popraw je i wyÅ›lij poprawionÄ… wersjÄ™ do tÅ‚umacza. Upewnij siÄ™ przedtem czy masz najnowszÄ… wersjÄ™, bo może bÅ‚Ä™dy, które poprawiasz sÄ… już poprawione w nowszej wersji. JeÅ›li chcesz ingerować w treść dokumentu, to postÄ™puj wg poniższej instrukcji: · zachowaj kopiÄ™ tÅ‚umaczenia · nanieÅ› poprawki, które uważasz za stosowne · programem ddiiffff utwórz plik zmian wydajÄ…c polecenie: ___________________________________________________________________ diff -Nu stara-wersja nowa-wersja > zmiany ___________________________________________________________________ · tak utworzony plik zmiany wyÅ›lij do tÅ‚umacza 22.. SSÅ‚Å‚oowwnniikk JeÅ›li znajdziesz jakieÅ› nowe sÅ‚owo/wyrażenie, które nadaje siÄ™ do sÅ‚ownika, albo znajdziesz lepsze okreÅ›lene dla któregoÅ› sÅ‚owa/wyrażenia już bÄ™dÄ…cego w sÅ‚owniku, to wyÅ›lij je do Bartka Maruszewskiego B.Maruszewski@jtz.org.pl. ** v3.4.6 ** acknowledgement - podziÄ™kowania (jako tytuÅ‚ sekcji), wyrazy uznania actual - rzeczywisty, ostateczny, faktyczny, bieżący adapter - sterownik affect - dotyczyć, mieć negatywny wpÅ‚yw na aggregate works - prace zebrane arrangement - ustawienie aspect ratio - współczynik ksztaÅ‚tu/obrazu based - oparty na bit bucket - kosz na bity boot - zaÅ‚adować, wystartować system, boot diskette - dyskietka startowa boot prompt - zachÄ™ta startowa broadcasting - rozgÅ‚aszanie, nadawanie can access - ma dostÄ™p carry out - wypeÅ‚nij, wykonać, przeprowadzić chip - ukÅ‚ad scalony command - polecenie command output - wynik/rezultat polecenia (to) crash - wywalić siÄ™, zaÅ‚amanie, pad/paść credits - wyrazy uznania debug - odpluskwiać derivative works - prace pochodne disable - wyÅ‚Ä…czyć disclaimer - zastrzeżenie driver - sterownik to edit - (z)modyfikowac entry - pozycja EPROM burner - programator eprom-ów expire - wygasnąć feed - zasilać, zasilanie, dostarczać figure out - stwierdzić filesystem - system plików flexibility - elastyczność for details - wiÄ™cej na temat szczegółów dotyczÄ…cych hack - przerobić (odnoÅ›nie jÄ…dra Linuksa) hardware - sprzÄ™t header/include files - pliki nagłówkowe interface - interfejs introduction - wprowadzenie issue a command - wykonać xxx issue - sprawa dotyczÄ…ca xxx jumper - zworka, przeÅ‚Ä…cznik kill - usun (o procesie) learn about - nauczyć siÄ™, dowiedzieć siÄ™ o line - wiersz maintain - opiekować siÄ™ maintained - prowadzony/pielÄ™gnowany/utrzymywany przez major - liczba główna man - podrÄ™cznik (man) map - odwzorowywać masquerading - maskowanie memory window - ramka pamiÄ™ci minor - liczba poboczna mirror - kopia normal - zwykly note - zauważ, uwaga, zapamiÄ™taj obey - podlegać, być posÅ‚usznym override -- zmienić, nadpisać pipe -- potok poll - sprawdzać, próbkować, monitorować probe - przeszukiwać, sprawdzać, wykrywać, dokonywać detekcji processed - interpretowane, przetwarzane prompt - zachÄ™ta put - umieÅ›cić to query - pytać, sprawdzać reboot - przeÅ‚adowanie reflect - odzwierciedlać release - wersja, wydanie root - administrator root filesystem - główny system plików section - rozdziaÅ‚ shadow - przesÅ‚aniać share - współdzielić shell - powÅ‚oka, interpreter shell prompt - zachÄ™ta powÅ‚oki, interpretera software - oprogramowanie spool directory - katalog zadaÅ„, katalog buforowania stream -- strumieÅ„ support - obsÅ‚ugiwać symbolic link - doÅ‚Ä…czenie/dowiÄ…zanie/wskazanie symboliczne system call - funkcja systemowa terms of use - warunki stosowania/używania/korzystania third-party books - książki wydawnictw/autorów, nie zwiÄ…zanych z firmÄ… produkujÄ…cÄ… opisywanÄ… rzecz albo książki osób trzecich total - caÅ‚kowity tune - ustawić, dostroić unlike - w przeciwieÅ„stwie do, niepodobny do upgrade - odnawianie, odswieżanie, uaktualnianie usage - stosowanie using this technique - za pomocÄ… tego sposobu, tym sposobem utility, tool - narzÄ™dzie work-around - obejÅ›ci X - nazwa systemu graficznych okienek uniksa to: X X Window System X Version 11 X Window System, Version 11 X11 ***** Å»adnej innej _SZCZEGÓLNIE_ *XWindows* nie przyjmujÄ™ ***** skróty od zwrotów: - wedÅ‚ug - wg - wyżej wymienione - ww. ========================================================== Wyrazy których nie tÅ‚umaczymy: firewall, bridge, host, proxy, log, stdin, stdout, locale, *roff, timeout, routing, router mieszczÄ… siÄ™ tutaj także wszelkie polecenia systemowe i nazwy programów X, emacs, *TeX, *script. =========================================================== Jak odmieniać wyrazy nietÅ‚umaczone, zaczerpniÄ™te z j. angielskiego oraz wszelkie skróty? Wyrazy zaczerpniÄ™te z ang. to takie jak: Linux, Unix, fax... *************** UWAGA *************** Odmiana sÅ‚owa Linux: (podajÄ™ za sÅ‚ownikiem jÄ™zyka polskiego) ten Linux tego Linuksa temu Linuksowi tego Linuksa z Linuksem o Linuksie O! Linuksie. :) Å»adnej innej nie przyjmujÄ™. JeÅ›li znajdÄ™ w jakimÅ› tÅ‚umaczeniu: Linuxie, Linux-ie itp, to NIE AKCEPTUJE go. JeÅ›li wyraz koÅ„czy siÄ™ na spółgÅ‚oskÄ™, to piszemy koÅ„cówkÄ™ polskÄ… wg rodzaju jaki dany wyraz przyjmuje w j. polskim (NIE STOSUJEMY myslnikow do oddzielenia polskiej koncowki od skrotu): np: ten firewall -- tego firewalla ten RAM -- tego RAMu W dopeÅ‚niaczu (kogo? czego?) skrótu koÅ„czÄ…cego siÄ™ na spółgÅ‚oskÄ™ zawsze używamy koÅ„cówki 'u': DOSu, BIOSu itd. JeÅ›li wyraz koÅ„czy siÄ™ na samogÅ‚oskÄ™, to dodajemy apostrof i piszemy koÅ„cówkÄ™ polskÄ… wg rodzaju jaki dany wyraz przyjmuje w j. polskim: np: ten bridge - tego bridge'a JeÅ›li wyraz koÅ„czy 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 ... 33.. FFoorrmmaatt ttÅ‚Å‚uummaacczzoonnyycchh ddookkuummeennttóóww:: SSGGMMLL WczeÅ›niej już zostaÅ‚o wspomniane, że piszemy w formacie SGML. Format ten bardzo przypomina HTML wiÄ™c jeÅ›li znasz ten ostatni, to nie powinien on ci nastrÄ™czać wiÄ™kszych trudnoÅ›ci. Do konwersji z formatu SGML na inne formaty sÅ‚uży pakiet ssggmmll--ttoooollss. WiÄ™cej informacji o tym pakiecie można znaleźć na stronie projektu SGMLTools Pakiet sgml-tools wywodzi siÄ™ od dawnego pakietu linuxdoc-sgml. ZmianÄ™ nazwy pakietu argumentuje siÄ™ tym, że poprzednia nazwa wiÄ…zaÅ‚a pakiet z Linuxem, co nie byÅ‚o zgodne z rzeczywistoÅ›ciÄ…. Można go byÅ‚o używać również pod kontrolÄ… innych systemów operacyjnych. Aktualnie projekt ten jest chwilowo zawieszony, wiÄ™c z wszelkimi problemami musimy rodzić sobie sami. Aktualne wersje tego pakietu sÄ… dwie: · 11..00..99 - ostatnia wersja pakietu wspierajÄ…ca DTD lliinnuuxxddoocc. · 22..00..22 - najnowsza wersja pakietu. Od wersji 2.0 nie obsÅ‚ugiwany jest DTD lliinnuuxxddoocc tylko DTD ddooccbbooookk. Część zasobów HOWTO/JTZ jest w formacie lliinnuuxxddoocc, część w ddooccbbooookk -- format jest zawsze zdeklarowany w pierwszej linii dokumentu. Zasada jest taka, że tÅ‚umaczymy dokument w takim formacie, w jakim jest oryginaÅ‚. WiÄ™cej informacji nt. pracy z obywdoma formatami znajdziesz poniżej. 33..11.. DDooccbbooookk 33..11..11.. IInnffoorrmmaaccjjee oo ttÅ‚Å‚uummaacczzuu Wg LDP dane nt. tÅ‚umacza w dokumentach o formacie DOCBOOK podawać należy w nagłówkach w sposób nastÄ™pujÄ…cy: ______________________________________________________________________ ImiÄ™ Nazwisko

adres.email@tłumacza.pl

Wersja polska: 6.66, 22 września 2004 ______________________________________________________________________ 33..11..22.. WWiięęcceejj nntt.. ddooccbbooookk Więcej informacji nt. pisania w docbook i konwertowania tych dokumentów na inne formaty znajdziesz pod adresem . 33..22.. LLiinnuuxxddoocc 33..22..11.. IInnffoorrmmaaccjjee oo ttłłuummaacczzuu Dane nt. tłumacza w dokumentach o formacie LINUXDOC podawać należy w nagłówkach w sposób następujący: ______________________________________________________________________