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 9.0 "stretch" 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 stretch, zawiera najnowsze oficjalnie wydanie dystrybucji Debian. Dystrybucja testing, tymczasowo nadana nazwa kodowa to buster, ​​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 buster 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

- Trent W. Buck

44

1.4 Wnoszenie wkładu do tego dokumentu

45

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.

46

1.4.1 Nanoszenie zmian

47

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:

48

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

49

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

50

$ make build

51

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.:

52

$ make build PROOF=1

53

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

54

$ make build LANGUAGES=pl

55

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

56

$ make build FORMATS=pdf

57

Lub kombinacja obu, np:

58

$ make build LANGUAGES=pl FORMATS=html

59

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.

60

1.4.2 Tłumaczenie

61

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

62

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:

63

- Rozpocznij nowe tłumaczenie od zera

64

- 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.

65

- 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`.

66

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

67

- 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) .

68

- 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

69

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.

70

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.

71

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.

72

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.