diff options
| -rw-r--r-- | debian/changelog | 4 | ||||
| -rwxr-xr-x | debian/rules | 2 | ||||
| -rw-r--r-- | doc/pl/offline.pl.sgml | 180 |
3 files changed, 94 insertions, 92 deletions
diff --git a/debian/changelog b/debian/changelog index bf71480cc..0ca0b5223 100644 --- a/debian/changelog +++ b/debian/changelog @@ -4,8 +4,10 @@ apt (0.6.31) hoary; urgency=low * Apply patch from Anthony Towns to allow SHA1Summation to process a file descriptor until EOF, rather than requiring that the length of input be specified (Closes: #291338) + * Fix build/install of Polish offline documentation, based on patch from + Christian Perrier (Closes: #270404) - -- + -- Matt Zimmerman <mdz@ubuntu.com> Fri, 4 Feb 2005 10:23:01 -0800 apt (0.6.30) unstable; urgency=low diff --git a/debian/rules b/debian/rules index b756b3b32..e3254c2d2 100755 --- a/debian/rules +++ b/debian/rules @@ -171,7 +171,7 @@ apt-doc: build-doc # # Copy the guides dh_installdocs -p$@ $(BLD)/docs/guide*.text $(BLD)/docs/guide*.html \ - $(BLD)/docs/offline.text $(BLD)/docs/offline.html + $(BLD)/docs/offline*.text $(BLD)/docs/offline*.html dh_installchangelogs -p$@ dh_compress -p$@ dh_fixperms -p$@ diff --git a/doc/pl/offline.pl.sgml b/doc/pl/offline.pl.sgml index 48f84e3b1..2adb2554d 100644 --- a/doc/pl/offline.pl.sgml +++ b/doc/pl/offline.pl.sgml @@ -1,80 +1,80 @@ <!doctype debiandoc system> <!-- -*- mode: sgml; mode: fold -*- --> <book> -<title>Używanie APT w trybie offline</title> +<title>Uďż˝ywanie APT w trybie offline</title> <author>Jason Gunthorpe <email>jgg@debian.org</email></author> -<author>Polskie tłumaczenie Krzysztof Fiertek <email>akfedux@megapolis.pl</email></author> +<author>Polskie tďż˝umaczenie Krzysztof Fiertek <email>akfedux@megapolis.pl</email></author> <version>$Id: offline.pl.sgml,v 1.1 2004/07/29 16:43:13 mdz Exp $</version> <abstract> -Dokument ten opisuje jak używać programu APT w środowiskach niesieciowych, -a w szczególności metodę pozwalającą na robienie aktualizacji systemu. +Dokument ten opisuje jak uďż˝ywaďż˝ programu APT w ďż˝rodowiskach niesieciowych, +a w szczegďż˝lnoďż˝ci metodďż˝ pozwalajďż˝cďż˝ na robienie aktualizacji systemu. </abstract> <copyright> Copyright © Jason Gunthorpe, 1999. <p> -Copyright © polskiego tłumaczenia Krzysztof Fiertek, 2004. +Copyright © polskiego tďż˝umaczenia Krzysztof Fiertek, 2004. <p> -"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. +"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. <p> -Więcej szczegółów możesz uzyskać przeglądając plik zawierający pełny tekst +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). </copyright <toc sect> -<chapt>Wstęp +<chapt>Wstďż˝p <!-- Overview {{{ --> <!-- ===================================================================== --> <sect>Wprowadzenie <p> -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. +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. <p> -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 +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. <p> -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. +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. </sect> <!-- }}} --> -<chapt>Używanie programu APT na obu komputerach +<chapt>Uďż˝ywanie programu APT na obu komputerach <!-- Overview {{{ --> <!-- ===================================================================== --> <sect>Wprowadzenie <p> -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: +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: <example> /disc/ @@ -94,21 +94,21 @@ powinna wyglądać następująco: <sect>Plik konfiguracyjny <p> -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ą -<em>/var/lib/dpkg/status</em>. Zauważ, że jeśli używasz lokalnego archiwum -musisz użyć tych samych odnośników o identycznej składni. +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ďż˝ +<em>/var/lib/dpkg/status</em>. Zauwaďż˝, ďż˝e jeďż˝li uďż˝ywasz lokalnego archiwum +musisz uďż˝yďż˝ tych samych odnoďż˝nikďż˝w o identycznej skďż˝adni. <p> -<em>apt.conf</em> musi zawierać niezbędne wpisy, by APT korzystał z dysku: +<em>apt.conf</em> musi zawieraďż˝ niezbďż˝dne wpisy, by APT korzystaďż˝ z dysku: <example> APT { - /* Ten wpis nie jest wymagany jeśli oba komputery są tej samej - architektury, mówi on APTowi na komputerze pobierającym pakiety + /* 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"; @@ -117,12 +117,12 @@ musisz użyć tych samych odnośników o identycznej składni. Dir { - /* Użyj katalogu disc na informacje stanu i skieruj plik status + /* 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 + // Katalog lokalnie przechowywanych pakietďż˝w binarnych Cache::archives "/disc/archives/"; Cache "/tmp/"; @@ -131,15 +131,15 @@ musisz użyć tych samych odnośników o identycznej składni. }; </example> -Więcej szczegółów można zobaczyć w manualu apt.conf i w przykładowym pliku +Wiďż˝cej szczeg���w moďż˝na zobaczyďż˝ w manualu apt.conf i w przykďż˝adowym pliku konfiguracyjnym <em>/usr/doc/apt/examples/apt.conf</em>. <p> -Pierwszą rzeczą jaka należy zrobić na oddalonym komputerze z Debianem to -zamontować dysk i przekopiować na niego plik <em>/var/lib/dpkg/status</em>. -Potrzeba także utworzyć stukturę katalogów przedstawioną we Wprowadzeniu, -<em>archives/partial/</em> i <em>lists/partial/</em>. Następnie niesiemy -dysk do oddalonego komputera z szybkim łączem i konfigurujemy plik +Pierwszďż˝ rzeczďż˝ jaka naleďż˝y zrobiďż˝ na oddalonym komputerze z Debianem to +zamontowaďż˝ dysk i przekopiowaďż˝ na niego plik <em>/var/lib/dpkg/status</em>. +Potrzeba takďż˝e utworzyďż˝ stukturďż˝ katalogďż˝w przedstawionďż˝ we Wprowadzeniu, +<em>archives/partial/</em> i <em>lists/partial/</em>. Nastďż˝pnie niesiemy +dysk do oddalonego komputera z szybkim ��czem i konfigurujemy plik sources.list. Na oddalonym komputerze wykonujemy kolejno: <example> @@ -151,54 +151,54 @@ sources.list. Na oddalonym komputerze wykonujemy kolejno: </example> -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 <em>dselect</em>. Jednak stworzy to problem w przeniesieniu -twoich operacji wyborów z powrotem na lokalny komputer. +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 <em>dselect</em>. Jednak stworzy to problem w przeniesieniu +twoich operacji wyborďż˝w z powrotem na lokalny komputer. <p> W tej chwili katalog disc zawiera wszystkie pliki indeksowe oraz archiwa -niezbędne do aktualizacji maszyny z Debianem. Bierzemy dysk z powrotem do +niezbďż˝dne do aktualizacji maszyny z Debianem. Bierzemy dysk z powrotem do siebie i wpisujemy: <example> # export APT_CONFIG="/disc/apt.conf" # apt-get check - [ APT tworzy lokalną kopię plików cache ] + [ 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 ] + [ Moďż˝e teďż˝ byďż˝ inne polecenie programu APT ] </example> <p> -Koniecznym jest do prawidłowego działania podmienić plik status na lokalnej -maszynie. To jest bardzo ważne! +Koniecznym jest do prawidďż˝owego dziaďż˝ania podmieniďż˝ plik status na lokalnej +maszynie. To jest bardzo waďż˝ne! <p> -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!! +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!! </sect> <!-- }}} --> -<chapt>Używanie programów APT i wget +<chapt>Uďż˝ywanie programďż˝w APT i wget <!-- Overview {{{ --> <!-- ===================================================================== --> <sect>Wprowadzenie <p> -<em>wget</em> 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. +<em>wget</em> 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. <p> -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 +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. </sect> @@ -208,28 +208,28 @@ pakiety. <sect>Kolejne kroki <p> -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. +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. <example> # apt-get dist-upgrade - [ Wybierz no po znaku zachęty, upewnij się czy to właściwy wybór ] + [ 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 </example> -Także inne opcje niż dist-upgrade mogą tu być użyte, włączając +Takďż˝e inne opcje niďż˝ dist-upgrade mogďż˝ tu byďż˝ uďż˝yte, w��czajďż˝c dselect-upgrade. <p> -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. +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. <p> -Na oddalonym komputerze należy wykonać coś takiego +Na oddalonym komputerze naleďż˝y wykonaďż˝ coďż˝ takiego <example> # cd /disc @@ -237,14 +237,14 @@ Na oddalonym komputerze należy wykonać coś takiego [ czekaj.. ] </example> -Gdy archiwa zostały pobrane i dysk wrócił do komputera z Debianem, -instalowanie można prowadzić dalej poleceniem, +Gdy archiwa zostaďż˝y pobrane i dysk wrďż˝ciďż˝ do komputera z Debianem, +instalowanie moďż˝na prowadziďż˝ dalej poleceniem, <example> # apt-get -o dir::cache::archives="/disc/" dist-upgrade </example> -Które użyje pobrane uprzednio archiwa z dysku. +Ktďż˝re uďż˝yje pobrane uprzednio archiwa z dysku. </sect> <!-- }}} --> </book> |