4

1. O tym podręczniku

5

This manual serves as a single access point to all documentation related to the Debian Live Project and in particular applies to the software produced by the project for the Debian "bookworm" release. An up-to-date version can always be found at ‹https://live-team.pages.debian.net/live-manual/›

6

Podczas, gdy podręcznik live-manual skupia się przede wszystkim na pomocy w budowaniu systemu live, a nie na tematach użytkownika końcowego. To użytkownik końcowy również może znaleźć przydatne informacje w następujących sekcjach: Podstawy obejmuje pobieranie skompilowanych obrazów i przygotowanie obrazów tak aby były uruchamiany z nośnika przenośnego lub z sieci, równocześnie używanie web builder lub uruchamianie live-build bezpośrednio w systemie. Dostosowywanie zachowania w czasie działania systemu opisuje kilka opcji, które mogą zostać określone podczas startu, na przykład wybieranie układu klawiatury i ustawienia regionalne, używając opcji persistence.

7

Niektóre z poleceń zawartych w tekście muszą być wykonywane z uprawnieniami superużytkownika, które mogą być uzyskane przez stanie się użytkownikiem root poprzez su lub używając sudo. Aby odróżnić te polecenia, które mogą być wykonywane przez nieuprzywilejowanego użytkownika i te wymagające praw administratora, polecenia zostały poprzedzone przez odpowiednio by $ or # . Symbol ten nie jest częścią polecenia.

8

1.1 Dla niecierpliwych

9

Wierzymy, że wszystko w tym podręczniku jest ważne, przynajmniej dla niektórych z naszych użytkowników. Zdajemy sobie sprawę również, że zawiera on dużo materiału do sprostania. I że może chciałbyś doświadczyć szybkich postępów w używaniu oprogramowania przed zagłębianiem się w szczegóły. Dlatego sugerujemy czytanie w następującej kolejności.

10

Najpierw przeczytaj rozdział, O tym podręczniku, od początku, kończąc na sekcji Warunki. Następnie przejdź do trzech ćwiczeń na początku sekcji Przykłady mającej na celu nauczyć Cię podstaw budowania obrazu i dostosowywania. Najpierw przeczytaj Używanie przykładów, następnie Tutorial 1: Domyślny obraz, Tutorial 2: Narzędzie przeglądarka i wreszcie Tutorial 3: Spersonalizowany obraz. Pod koniec tych tutoriali, będziesz mieć ogólny zarys tego, co można zrobić z systemami live.

11

Zachęcamy do powrotu i bardziej dogłębnej analizy podręcznika, być może następnym razem czytanie Podstaw, przejrzenie lub pominięcie Budowanie obrazu netboot, a skończywszy czytając Omówienie dostosowywania i rozdziałów, które po nim następują. W tym momencie, mamy nadzieję, że są zostałeś zainteresowany tym, co można zrobić z systemami live i zmotywowany, aby przeczytać resztę tego podręcznika, od deski do deski.

12

1.2 Definicje

13

• System live: System operacyjny, który można uruchomić bez instalacji na dysku twardym. Systemy live nie zmieniają lokalnego systemu(-ów) lub pliku(-ów) już zainstalowany na dysku twardym komputera, chyba że zostało to specjalnie ustawione. Systemy live są zwykle uruchamiane z nośników takich jak płyty CD, DVD lub pamięci USB. Niektóre mogą się także uruchamiać z sieci (za pośrednictwem obrazów netboot, patrz Budowanie obrazu netboot) i przez Internet (za pomocą parametru startowego fetch=URL, patrz Webbooting). webbooting).

14

• Nośnik live: W odróżnieniu od systemu live, nośnik live odnosi się do dysku CD, DVD lub pamięci USB, gdzie znajdują się pliki binarne stworzone przez live-build, które są używane do uruchamiania systemu live. Szerzej, termin ten odnosi się również do każdego miejsca, w którym znajdują się te pliki binarne, które są potrzebne do uruchomienia systemu live, również takich miejsc jak miejsca dla plików startowych w sieci.

15

• Debian Live Project: Projekt, który dostarcza, między innymi pakiety: live-boot, live-build, live-config, live-tools i live-manual.

16

• System hosta: Środowisko użyte do stworzenia systemu live.

17

• System docelowy: Środowisko użyte do uruchomienia systemu live.

18

• live-boot: Zbiór skryptów wykorzystywanych do uruchamiania systemów live.

19

• live-build: Zbiór skryptów wykorzystywanych do budowy niestandardowych systemów live.

20

• live-config: Zbiór skryptów używane do konfiguracji systemu live w czasie procesu bootowania.

21

• live-tools: Zbiór dodatkowych skryptów wykorzystywanych do wykonywania pożytecznych zadań w ramach uruchomionego systemu live.

22

• live-manual: Dokument ten jest tworzony w pakiecie o nazwie live-manual.

23

• Debian Installer (d-i): Oficjalny system instalacyjny dystrybucji Debian.

24

• Parametry startowe: Parametry, które mogą być wprowadzone w wierszu bootloadera, aby wpłynąć na jądro lub live-config.

25

• chroot: Program chroot, chroot(8), pozwala na uruchomienie różnych instancji środowiska GNU / Linux na jednym systemie bez ponownego uruchomiania go.

26

• Obraz binarny: Plik zawierający system live, takie jak live-image-i386.hybrid.iso lub live-image-i386.img.

27

• Dystrybucja docelowa: dystrybucja, na której opierać się będzie system żywo. To może się różnić od dystrybucji systemu hosta.

28

• stable/testing/unstable: Dystrybucja stable, obecnia nazwa kodowa to bookworm, zawiera najnowsze oficjalnie wydanie dystrybucji Debian. Dystrybucja testing, tymczasowo nadana nazwa kodowa to trixie, ​​to obszar postoju przed następnym wydaniem stable. Główną zaletą korzystania z tej dystrybucji jest to, że zawiera nowsze wersje oprogramowania w stosunku do wydania stable. Dystrybucja unstable, trwale nazwana sid, to ta gdzie zachodzi aktywny rozwój Debian. Ogólnie rzecz biorąc, to dystrybucja prowadzona jest przez deweloperów i tych, którzy lubią życie na krawędzi. W tym podręczniku, mamy tendencję do korzystania z nazw kodowych wydań, takich jak trixie lub sid, bo głównie w tych wydaniach jest zawarte to co aktualnie zawierają narzędzia same w sobie.

29

1.3 Autorzy

30

Lista Autorów (w kolejności alfabetycznej):

31

• Ben Armstrong

32

• Brendan Sleight

33

• Carlos Zuferri

34

• Chris Lamb

35

• Daniel Baumann

36

• Franklin Piat

37

• Jonas Stein

38

• Kai Hendry

39

• Marco Amadori

40

• Mathieu Geli

41

• Matthias Kirschner

42

• Richard Nelson

43

• Roland Clobus

44

• Trent W. Buck

45

1.4 Wnoszenie wkładu do tego dokumentu

46

Intencją niniejszy podręcznik jest dziłanie jako projekt społeczny, a więc wszelkie propozycje usprawnień i zmian są bardzo mile widziane. Proszę przejrzyj sekcję Przyczynianie się do projektu w celu uzyskania szczegółowych informacje na temat sposobu pobrania klucza do wysyłania zmian i jak wnosić dobre zmiany.

47

1.4.1 Nanoszenie zmian

48

W celu dokonania zmian w podręczniku angielskim musisz edytować odpowiednie pliki w manual/en/, ale przed złożeniem swojego wkładu, należy przejrzeć swoją pracę. Aby wyświetlić podgląd live-manual, upewnij się, że pakiety potrzebne do budowy to są zainstalowane przez wykonanie:

49

# apt-get install make po4a ruby ruby-nokogiri sisu-complete

50

Możesz zbudować live-manual z głównego katalogu swojego zapytania GIT przez wykonanie:

51

$ make build

52

Ponieważ zbudowanie podręcznika we wszystkich obsługiwanych językach zajmuje trochę czasu, autorzy mogą zdecydować, że wygodniej będzie skorzystać z jednego z szybko korygujących skrótów podczas zamieszczania nowej dokumentacji, którą dodali do podręcznika angielskiego. Używanie PROOF=1 tworzy live-manual w formacie HTML, ale bez posegmentowanych plików HTML, a przy użyciu PROOF=2 tworzy się live-manual w formacie PDF, ale tylko sformatowane jako A4 i listowy pionowy. Dlatego korzystając z jednej z możliwości opcji PROOF= można zaoszczędzić sporo czasu, np.:

53

$ make build PROOF=1

54

Gdy zatwierdzasz jedno z tłumaczeń możliwe jest zbudowanie tylko dla jednego języka, przez wykonanie, np.:

55

$ make build LANGUAGES=pl

56

Jest też możliwe, aby zbudować po typie dokumentu, np:

57

$ make build FORMATS=pdf

58

Lub kombinacja obu, np:

59

$ make build LANGUAGES=pl FORMATS=html

60

Po rewizji swojej pracy i upewnieniu się, że wszystko jest w porządku, nie należy używać make commit chyba aktualizujesz już istniejące tłumaczenia, i w tym przypadku, nie należy mieszać zmian do instrukcji angielskiej i tłumaczeń w tej samej wysłanej zmianie, ale należy użyć osobnych zgłoszeń zmian dla każdego tłumaczenia. Zobacz sekcję Tłumaczenie, aby uzyskać więcej szczegółów.

61

1.4.2 Tłumaczenie

62

Note: For the translation of the man pages see Translation of man pages

63

W celu przetłumaczenia live-manual, wykonaj następujące kroki, w zależności od tego, czy rozpoczynasz tłumaczenie od zera czy też kontynuujesz pracę na już istniejącym tłumaczeniu:

64

• Rozpocznij nowe tłumaczenie od zera

65

• Przetłumacz pliki about_manual.ssi.pot, about_project.ssi.pot i index.html.in.pot w manual/pot/ na swój język używając swojego ulubionego edytora (np. poedit) i wyślij przetłumaczony plik .po do listy mailingowej, aby sprawdzić ich integralność. Sprawdzanie integralności live-manual sprawdza, nie tylko czy pliki .po są w 100% przetłumaczone, ale również wykrywa ewentualne błędy.

66

• Once checked, to enable a new language in the autobuild it is enough to add the initial translated files to manual/po/${LANGUAGE}/ and edit manual/_sisu/home/index.html adding the name of the language and its name in English between brackets. And then, add the folder manual/${LANGUAGE}/ to the file .gitignore. Finally, run make commit.

67

• Kontynuuj pracę z już rozpoczętym tłumaczeniem

68

• Jeśli Twój język docelowy został już dodany, można losowo kontynuować tłumaczenia pozostałych plików .po w manual/po/${LANGUAGE}/ za pomocą dowolnego edytora (np. poedit) .

69

• Nie zapomnij, że musisz uruchomić make commit w celu zapewnienia, że przetłumaczone podręczniki są aktualizowane z plików .po i że możesz przeglądać swoje zmiany uruchomamiając make build przed git add ., następnie git commit -m "Translating..." (Tłumaczenie...) i git push. Pamiętaj, że polecenie make build może zająć dużo czasu, możesz wybrać indywidualnie korygowane języki jak wyjaśniono w Zatwierdzanie zmian

70

Po uruchomieniu make commit zobaczysz jakiś przewijający się tekst. Są to przede wszystkim informacyjne komunikaty o statusie przetwarzania, a także niektóre wskazówki na temat tego, co mogłoby być zrobione, aby poprawić live-manual. Chyba, że widzisz błąd krytyczny, zazwyczaj w takim wypadku możesz kontynuować i wysłać swój wkład w tłumaczenie.

71

live-manual składa się z dwóch narzędzi, które mogą w znacznym stopniu pomóc tłumaczom znaleźć nieprzetłumaczone i zmienione ciągi znaków. Pierwszy z nich jest "make translate". Uruchamia skrypt, który mówi dokładnie ile nie przetłumaczonych ciągów jest ​​w każdym pliku .po. Drugi, "make fixfuzzy", działa tylko na zmienionych ciągach znaków, ale to pomaga znaleźć je i edytować jeden po drugim.

72

Należy pamiętać, że nawet jeśli te narzędzia mogą być bardzo pomocne do pracy z tłumaczeniami w linii poleceń, to korzystanie z wyspecjalizowanego narzędzia jak poedit jest zalecanym sposobem, aby wykonać zadanie. Jest to również dobry pomysł, aby zapoznać się z dokumentacjami Debian o lokalizacjach (l10n) i tymi specyficznymi dla live-manual: Poradnik dla tłumaczy.

73

Uwaga: Możesz użyć make clean aby oczyścić swoje drzewo git przed zamieszczeniem. Ten krok nie jest obowiązkowy, dzięki plikowi .gitignore, ale dobrą praktyką jest uniknać zatwierdzania plików odruchowo.