From c5bb61fd5a77c5743deb95a1fe0b3a48b10be405 Mon Sep 17 00:00:00 2001 From: "bubulle@debian.org" <> Date: Sat, 15 Mar 2008 19:02:15 +0100 Subject: [PATCH] Fix Polish offline translation --- buildlib/debiandoc.mak | 2 +- debian/changelog | 2 + doc/pl/makefile | 1 + doc/pl/offline.pl.sgml | 502 +++++++++++++++++++++-------------------- 4 files changed, 256 insertions(+), 251 deletions(-) rewrite doc/pl/offline.pl.sgml (71%) diff --git a/buildlib/debiandoc.mak b/buildlib/debiandoc.mak index 0c20dc91..f3347410 100644 --- a/buildlib/debiandoc.mak +++ b/buildlib/debiandoc.mak @@ -27,7 +27,7 @@ vpath %.sgml $(SUBDIRS) $(DOC)/%.html: %.sgml echo Creating html for $< to $@ -rm -rf $@ - (HERE=`pwd`; cd $(@D) && $(DEBIANDOC_HTML) $$HERE/$<) + (HERE=`pwd`; cd $(@D) && $(DEBIANDOC_HTML) $(DEBIANDOC_HTML_OPTIONS) $$HERE/$<) # Clean rule .PHONY: veryclean/html/$(LOCAL) diff --git a/debian/changelog b/debian/changelog index ff2d56cc..9d227f09 100644 --- a/debian/changelog +++ b/debian/changelog @@ -34,6 +34,8 @@ apt (0.7.12) UNRELEASED; urgency=low * Fix syntax/copitalisation in some messages. Thanks to Jens Seidel for pointing this and providing the patch. Closes: #466845 + * Fix Polish offline translation. Thanks to Robert Luberda for the patch + and pologies for applying it very lately. Closes: #337758 [ Program translations ] - German updated. Closes: #466842 diff --git a/doc/pl/makefile b/doc/pl/makefile index 72a50542..94939e15 100644 --- a/doc/pl/makefile +++ b/doc/pl/makefile @@ -7,4 +7,5 @@ include ../../buildlib/defaults.mak # Debian Doc SGML Documents SOURCE = offline.pl.sgml +DEBIANDOC_HTML_OPTIONS=-l pl include $(DEBIANDOC_H) diff --git a/doc/pl/offline.pl.sgml b/doc/pl/offline.pl.sgml dissimilarity index 71% index 2adb2554..0d301d4f 100644 --- a/doc/pl/offline.pl.sgml +++ b/doc/pl/offline.pl.sgml @@ -1,250 +1,252 @@ - - - -U�ywanie APT w trybie offline - -Jason Gunthorpe jgg@debian.org -Polskie t�umaczenie Krzysztof Fiertek akfedux@megapolis.pl -$Id: offline.pl.sgml,v 1.1 2004/07/29 16:43:13 mdz Exp $ - - -Dokument ten opisuje jak u�ywa� programu APT w �rodowiskach niesieciowych, -a w szczeg�lno�ci metod� pozwalaj�c� na robienie aktualizacji systemu. - - - -Copyright © Jason Gunthorpe, 1999. -

-Copyright © polskiego t�umaczenia Krzysztof Fiertek, 2004. -

-"APT" i ten dokument s� oprogramowaniem wolnodost�pnym; mo�esz -rozpowszechnia� je i/lub zmienia� w zgodzie z postanowieniami -"Og�lnej Licencji Publicznej GNU" (GNU General Public License) -takiej, jak zosta�a opublikowana przez "Fundacje Wolnego -Oprogramowania (Free Software Foundation); albo w wersji 2 tej�e -licencji, albo (tw�j wyb�r) w dowolnej p��niejszej. - -

-Wi�cej szczeg���w mo�esz uzyska� przegl�daj�c plik zawieraj�cy pe�ny tekst -licencji (w systemach Debian jest to plik /usr/doc/copyright/GPL). - - -Wst�p - - -Wprowadzenie - -

-Normalnie APT wymaga bezpo�redniego dost�pu do archiw�w Debiana poprzez -sie� lokaln� albo przez sie� internetow�. Kolejn� niedogodno�ci� mo�e by� -fakt, �e nasz komputer, kt�ry pracuje na wolnym ��czu takim jak modem, -jest znacznie oddalony od innnego komputera z szybkim ��czem. - -

-Rozwi�zaniem tego problemu jest u�ycie pojemnych przeno�nych no�nik�w -takich jak dyskietka Zip lub dysk SuperDisk. No�niki te nie s� -wystarczaj�co pojemne, by zgromadzi� kompletne archiwum Debiana, ale mo�na -�mia�o dopasowa� podzbi�r du�ego archiwum wystarczaj�cy dla wi�kszo�ci -u�ytkownik�w. Pomys� polega na tym, by u�y� programu APT do wygenerowania -listy pakiet�w, kt�re s� wymagane, nast�pnie pobraniu ich na dysk u�ywaj�c -innego komputera z w�a�ciw� zwarto�ci�. Jest nawet mo�liwe, by u�y� innego -komputera z Debianem z zainstalowanym programem APT lub zupe�nie innym -systemem operacyjnym i programem narz�dziowym do pobierania plik�w takim -jak wget. - -

-Osi�gni�te jest to przez tw�rcze manipulowanie plikiem konfiguracyjnym -programu APT. Rzecz� niezb�dn� jest poinformowanie programu APT, aby wskazywa� -na dysk z plikami archiwum. Nale�y zauwa�y�, �e dysk powinien by� -sformatowany do obs�ugi systemu plik�w takiego jak ext2, fat32 albo vfat -pozwalaj�cych pos�ugiwa� si� d�ugimi nazwami pliku. - - - - -U�ywanie programu APT na obu komputerach - - -Wprowadzenie - -

-APT b�d�cy do dyspozycji na obu komputerach daje najprostsz� kombinacj�. -Zasadniczym pomys�em tej metody jest umie�ci� kopie pliku status na dysku -i u�y� odleg�ego komputera, aby uzyska� najnowsze pliki pakiet�w -i zdecydowa�, kt�re pakiety chcemy pobra�. Struktura katalog�w na dysku -powinna wygl�da� nast�puj�co: - - - /disc/ - archives/ - partial/ - lists/ - partial/ - status - sources.list - apt.conf - - - - - - -Plik konfiguracyjny - -

-Plik konfiguracyjny powinien informowa� program APT, aby przechowywa� jego -pliki na dysku, a tak�e u�ywa� plik�w konfiguracyjnych z dysku. Plik -sources.list powinien zawiera� prawid�owe odno�niki, kt�rych oczekujesz -u�y� od zdalnego komputera, a plik status powinien by� kopi� -/var/lib/dpkg/status. Zauwa�, �e je�li u�ywasz lokalnego archiwum -musisz u�y� tych samych odno�nik�w o identycznej sk�adni. - -

-apt.conf musi zawiera� niezb�dne wpisy, by APT korzysta� z dysku: - - - APT - { - /* Ten wpis nie jest wymagany je�li oba komputery s� tej samej - architektury, m�wi on APTowi na komputerze pobieraj�cym pakiety - jakiej architektury jest nasz komputer */ - Architecture "i386"; - - Get::Download-Only "true"; - }; - - Dir - { - /* U�yj katalogu disc na informacje stanu i skieruj plik status - z /var/lib/dpkg default */ - State "/disc/"; - State::status "status"; - - // Katalog lokalnie przechowywanych pakiet�w binarnych - Cache::archives "/disc/archives/"; - Cache "/tmp/"; - - // Lokalizacja pliku sources.list. - Etc "/disc - }; - - -Wi�cej szczeg���w mo�na zobaczy� w manualu apt.conf i w przyk�adowym pliku -konfiguracyjnym /usr/doc/apt/examples/apt.conf. - -

-Pierwsz� rzecz� jaka nale�y zrobi� na oddalonym komputerze z Debianem to -zamontowa� dysk i przekopiowa� na niego plik /var/lib/dpkg/status. -Potrzeba tak�e utworzy� stuktur� katalog�w przedstawion� we Wprowadzeniu, -archives/partial/ i lists/partial/. Nast�pnie niesiemy -dysk do oddalonego komputera z szybkim ��czem i konfigurujemy plik -sources.list. Na oddalonym komputerze wykonujemy kolejno: - - - # export APT_CONFIG="/disc/apt.conf" - # apt-get update - [ APT aktualizuje ustawienia ] - # apt-get dist-upgrade - [ APT pobiera wszystkie potrzebne pakiety do aktualizacji twojego systemu ] - - - -Polecenie dist-upgrade mo�na zast�pi� ka�dym innym podstawowym poleceniem -APT, w szczeg�lno�ci dselect-upgrade. Mo�esz nawet u�y� APT jako metod� -dost�pu dla dselect. Jednak stworzy to problem w przeniesieniu -twoich operacji wybor�w z powrotem na lokalny komputer. - -

-W tej chwili katalog disc zawiera wszystkie pliki indeksowe oraz archiwa -niezb�dne do aktualizacji maszyny z Debianem. Bierzemy dysk z powrotem do -siebie i wpisujemy: - - - # export APT_CONFIG="/disc/apt.conf" - # apt-get check - [ APT tworzy lokaln� kopi� plik�w cache ] - # apt-get --no-d -o dir::etc::status=/var/lib/dpkg/status dist-upgrade - [ Mo�e te� by� inne polecenie programu APT ] - - -

-Koniecznym jest do prawid�owego dzia�ania podmieni� plik status na lokalnej -maszynie. To jest bardzo wa�ne! - -

-Je�li u�ywasz dselect mo�esz wykona� bardzo ryzykown� operacj� skopiowania -disc/status do /var/lib/dpkg/status tak, �e wszystkie zmiany kt�re -dokona�e� na odleg�ym komputerze s� uaktualnione. Mocno zalecam aby -dokonywa� doboru pakiet�w tylko na lokalnym komputerze, ale nie zawsze -jest to mo�liwe. NIE podmieniaj pliku status je�li dpkg lub APT by�y -uruchamiane w mi�dzyczasie!! - - - - -U�ywanie program�w APT i wget - - -Wprowadzenie - -

-wget jest popularnym i przeno�nym programem narz�dziowym -pobierania plik�w, kt�ry dzia�a na prawie ka�dym komputerze. -W przeciwie�stwie do metody opisanej powy�ej ta wymaga komputera z Debianem, -kt�ry ju� posiada list� dost�pnych pakiet�w. - -

-Nale�y stworzy� katalog disc tylko na pakiety do pobrania z innego -komputera. U�yta zostanie do tego opcja --print-uris programu apt-get, -a nast�pnie przygotujemy skrypt dla programu wget, kt�ry pobierze w�a�ciwe -pakiety. - - - - - -Kolejne kroki - -

-W odr��nieniu od poprzedniej metody dzia�ania ta nie wymaga specjalnych -plik�w konfiguracyjnych. U�ywamy jedynie podstawowych polece� APT, by -wygenerowa� list� plik�w. - - - # apt-get dist-upgrade - [ Wybierz no po znaku zach�ty, upewnij si� czy to w�a?ciwy wyb�r ] - # apt-get -qq --print-uris dist-upgrade > uris - # awk '{print "wget -O " $2 " " $1}' < uris > /disc/wget-script - - -Tak�e inne opcje ni� dist-upgrade mog� tu by� u�yte, w��czaj�c -dselect-upgrade. - -

-Plik skryptu /disc/wget-script b�dzie teraz zawiera� list� polece� dla -programu wget, kt�ry uruchomi w porz�dku pobieranie potrzebnych archiw�w. -Skrypt ten nale�y uruchomi� w bie��cym katalogu o punkcie montowania disc -tak aby tu zapisywa� dane na dysku. - -

-Na oddalonym komputerze nale�y wykona� co� takiego - - - # cd /disc - # sh -x ./wget-script - [ czekaj.. ] - - -Gdy archiwa zosta�y pobrane i dysk wr�ci� do komputera z Debianem, -instalowanie mo�na prowadzi� dalej poleceniem, - - - # apt-get -o dir::cache::archives="/disc/" dist-upgrade - - -Kt�re u�yje pobrane uprzednio archiwa z dysku. - - - + + + +U¿ywanie APT w trybie offline + +Jason Gunthorpe jgg@debian.org +Polskie t³umaczenie Krzysztof Fiertek akfedux@megapolis.pl +$Id: offline.sgml,v 1.8 2003/02/12 15:06:41 doogie Exp $ + + +Dokument ten opisuje u¿ywanie programu APT w ¶rodowiskach pozbawionych dostêpu, +do sieci, a w szczególno¶ci metodê pozwalaj±c± na robienie aktualizacji systemu. + + + +Copyright © Jason Gunthorpe, 1999. +

+Copyright © polskiego t³umaczenia Krzysztof Fiertek, 2004. +

+"APT" i ten dokument s± oprogramowaniem wolnodostêpnym; mo¿esz +rozpowszechniaæ je i/lub zmieniaæ w zgodzie z postanowieniami +"Ogólnej Licencji Publicznej GNU" (GNU General Public License) +takiej, jak zosta³a opublikowana przez "Fundacje Wolnego +Oprogramowania (Free Software Foundation); albo w wersji 2 tej¿e +licencji, albo (twój wybór) w dowolnej pó¼niejszej. + +

+Wiêcej szczegó³ów mo¿na uzyskaæ, przegl±daj±c plik zawieraj±cy pe³ny tekst +licencji (w systemach Debian jest to plik /usr/share/common-licenses/GPL). + + + + +Wstêp + + +Wprowadzenie + +

+Normalnie APT wymaga bezpo¶redniego dostêpu do archiwów Debiana przez +sieæ lokaln± albo przez sieæ internetow±. Kolejn± niedogodno¶ci± mo¿e byæ +fakt, ¿e nasz komputer, który pracuje na powolnym ³±czu takim jak modem, +jest znacznie oddalony od innego komputera z szybkim ³±czem. + +

+Rozwi±zaniem tego problemu jest u¿ycie pojemnych przeno¶nych no¶ników +takich jak dyskietka Zip lub dysk SuperDisk. No¶niki te nie s± +wystarczaj±co pojemne, by zgromadziæ kompletne archiwum Debiana, ale mo¿na +¶mia³o dopasowaæ podzbiór du¿ego archiwum wystarczaj±cy dla wiêkszo¶ci +u¿ytkowników. Pomys³ polega na tym, by u¿yæ programu APT do wygenerowania +listy pakietów, które s± wymagane, a nastêpnie pobraniu ich na dysk, u¿ywaj±c +innego komputera z w³a¶ciw± zwarto¶ci±. Jest nawet mo¿liwe, by u¿yæ innego +komputera z Debianem z zainstalowanym programem APT lub zupe³nie innym +systemem operacyjnym i programem narzêdziowym do pobierania plików takim +jak wget. + +

+Osi±gane jest to przez twórcze manipulowanie plikiem konfiguracyjnym +programu APT. Rzecz± niezbêdn± jest poinformowanie programu APT, aby wskazywa³ +na dysk z plikami archiwum. Nale¿y zauwa¿yæ, ¿e dysk powinien byæ +sformatowany do obs³ugi systemu plików pozwalaj±cego pos³ugiwaæ siê d³ugimi +nazwami plików (np. ext2, fat32 albo vfat). + + + + + +U¿ywanie programu APT na obu komputerach + + +Wprowadzenie + +

+APT bêd±cy do dyspozycji na obu komputerach daje najprostsz± kombinacjê. +Zasadniczym pomys³em tej metody jest umieszczenie kopii pliku status na dysku +i u¿ycie odleg³ego komputera, aby uzyskaæ najnowsze pliki pakietów +i zdecydowaæ, które pakiety trzeba pobraæ. Struktura katalogów na dysku +powinna wygl±daæ nastêpuj±co: + + + /disc/ + archives/ + partial/ + lists/ + partial/ + status + sources.list + apt.conf + + + + + + +Plik konfiguracyjny + +

+Plik konfiguracyjny powinien informowaæ program APT, aby przechowywa³ swoje +pliki na dysku, a tak¿e u¿ywa³ plików konfiguracyjnych z dysku. Plik +sources.list powinien zawieraæ prawid³owe odno¶niki, których nale¿y +u¿yæ na zdalnym komputerze, a plik status powinien byæ kopi± +/var/lib/dpkg/status. Zauwa¿, ¿e je¶li u¿ywasz lokalnego archiwum +musisz u¿yæ tych samych odno¶ników o identycznej sk³adni. + +

+apt.conf musi zawieraæ niezbêdne wpisy, by APT korzysta³ z dysku: + + + APT + { + /* Ten wpis nie jest wymagany, je¶li oba komputery maj± tê sam± + architekturê; mówi on programowi APT na komputerze pobieraj±cym + pakiety, jaka jest architektura naszego komputera */ + Architecture "i386"; + + Get::Download-Only "true"; + }; + + Dir + { + /* U¿yj katalogu disc na informacje stanu i przekieruj plik status + z domy¶lnego /var/lib/dpkg */ + State "/disc/"; + State::status "status"; + + // Katalog lokalnie przechowywanych pakietów binarnych + Cache::archives "/disc/archives/"; + + Cache "/tmp/"; + + // Lokalizacja pliku sources.list. + Etc "/disc"; + }; + + +Wiêcej szczegó³ów mo¿na zobaczyæ w stronie podrêcznika apt.conf i w przyk³adowym +pliku konfiguracyjnym /usr/share/doc/apt/examples/apt.conf. + +

+Pierwsz± rzecz±, jak± nale¿y zrobiæ na oddalonym komputerze z Debianem to +zamontowaæ dysk i przekopiowaæ na niego plik /var/lib/dpkg/status. +Trzeba tak¿e utworzyæ stukturê katalogów przedstawion± we "Wprowadzeniu": +archives/partial/ i lists/partial/. Nastêpnie niesiemy +dysk do oddalonego komputera z szybkim ³±czem i konfigurujemy plik +sources.list. Na oddalonym komputerze wykonujemy kolejno: + + + # export APT_CONFIG="/disc/apt.conf" + # apt-get update + [ APT aktualizuje ustawienia ] + # apt-get dist-upgrade + [ APT pobiera wszystkie pakiety potrzebne do aktualizacji Twojego systemu ] + + + +Polecenie dist-upgrade mo¿na zast±piæ ka¿dym innym podstawowym poleceniem +APT, w szczególno¶ci dselect-upgrade. Mo¿na nawet u¿yæ APT jako metody +dostêpu dla dselect. Jednak stworzy to problem w przeniesieniu +Twoich operacji wyborów z powrotem na lokalny komputer. + +

+W tej chwili katalog disc zawiera wszystkie pliki indeksowe oraz archiwa +niezbêdne do aktualizacji maszyny z Debianem. Bierzemy dysk z powrotem do +siebie i wpisujemy: + + + # export APT_CONFIG="/disc/apt.conf" + # apt-get check + [ APT tworzy lokaln± kopiê plików cache ] + # apt-get --no-d -o dir::state::status=/var/lib/dpkg/status dist-upgrade + [ Mo¿e te¿ byæ inne polecenie programu APT ] + + +

+Do prawid³owego dzia³ania koniecznie nale¿y podaæ plik status z lokalnej +maszyny. To jest bardzo wa¿ne! + +

+Je¶li u¿ywasz dselect, mo¿esz wykonaæ bardzo ryzykown± operacjê skopiowania +disc/status do /var/lib/dpkg/status, tak ¿e wszystkie zmiany, których +dokona³e¶ na odleg³ym komputerze, bêd± przeniesione. Mocno zalecam, aby +dokonywaæ doboru pakietów tylko na lokalnym komputerze, ale nie zawsze +jest to mo¿liwe. NIE podmieniaj pliku status, je¶li dpkg lub APT by³y +uruchamiane w miêdzyczasie!! + + + + +U¿ywanie programów APT i wget + + +Wprowadzenie + +

+wget jest popularnym i przeno¶nym programem narzêdziowym +pobierania plików, który dzia³a prawie na ka¿dym komputerze. +W przeciwieñstwie do metody opisanej powy¿ej ta wymaga, aby na lokalnym komputerze +by³a aktualna lista dostêpnych pakietów. + +

+Nale¿y stworzyæ katalog disc tylko na pakiety do pobrania z innego +komputera. U¿yta zostanie do tego opcja --print-uris programu apt-get, +a nastêpnie przygotujemy skrypt dla programu wget, który pobierze w³a¶ciwe +pakiety. + + + + + +Kolejne kroki + +

+W odró¿nieniu od poprzedniej metody dzia³ania ta nie wymaga specjalnych +plików konfiguracyjnych. U¿ywamy jedynie podstawowych poleceñ APT, by +wygenerowaæ listê plików. + + + # apt-get dist-upgrade + [ Wybierz "no" po znaku zachêty, upewnij siê, czy to w³a¶ciwy wybór ] + # apt-get -qq --print-uris dist-upgrade > uris + # awk '{print "wget -O " $2 " " $1}' < uris > /disc/wget-script + + +Tak¿e inne opcje ni¿ dist-upgrade mog± tu byæ u¿yte, w³±czaj±c +dselect-upgrade. + +

+Plik skryptu /disc/wget-script bêdzie teraz zawieraæ listê wywo³añ programu +wget, niezbêdnych do pobrania potrzebnych archiwów. +Skrypt ten nale¿y uruchomiæ w bie¿±cym katalogu o punkcie montowania disc, +tak aby tu zapisywa³ dane na dysku. + +

+Na oddalonym komputerze nale¿y wykonaæ co¶ takiego + + + # cd /disc + # sh -x ./wget-script + [ czekaj.. ] + + +Gdy archiwa zostan± pobrane i dysk wróci do komputera z Debianem, +instalowanie mo¿na prowadziæ dalej poleceniem: + + + # apt-get -o dir::cache::archives="/disc/" dist-upgrade + + +które u¿yje pobranych uprzednio archiwów z dysku. + + + -- 2.20.1