Live manual Debian Live

# Debian Live Manual

# O tym podręczniku

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

- Binary image: A file containing the live system, such as live-image-amd64.hybrid.iso or live-image-amd64.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.