From 7652e03e9909ac65dab11a8cabb9ea5b77ef95ca Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Thu, 1 Oct 2009 18:33:22 +0200 Subject: add guide.sgml and offline.sgml to the "translatable with po4a"-group Fix also the buildsystem for building the coresponding docs from these two files if they are exist for this language so we don't need to change the makefiles for ja and fr - and can also use the same simple makefiles for it and pl which ship these files as not-yet-with-po4a-translated (and currently no man page translation.) --- doc/pl/makefile | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'doc/pl') diff --git a/doc/pl/makefile b/doc/pl/makefile index 94939e156..7e77b29b9 100644 --- a/doc/pl/makefile +++ b/doc/pl/makefile @@ -5,7 +5,7 @@ SUBDIR=doc/pl # Bring in the default rules include ../../buildlib/defaults.mak -# Debian Doc SGML Documents -SOURCE = offline.pl.sgml -DEBIANDOC_HTML_OPTIONS=-l pl -include $(DEBIANDOC_H) +# Language Code of this translation +LC=pl + +include $(PO4A_MANPAGE_H) -- cgit v1.2.3 From b23898bf6f7b3eff2cac130d60639b5250be3177 Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Mon, 2 Nov 2009 09:52:58 +0100 Subject: convert pl to use po4a-style manpage translation --- doc/pl/offline.pl.sgml | 252 ------------------------------------------------- 1 file changed, 252 deletions(-) delete mode 100644 doc/pl/offline.pl.sgml (limited to 'doc/pl') diff --git a/doc/pl/offline.pl.sgml b/doc/pl/offline.pl.sgml deleted file mode 100644 index 0d301d4fb..000000000 --- a/doc/pl/offline.pl.sgml +++ /dev/null @@ -1,252 +0,0 @@ - - - -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. - - - -- cgit v1.2.3