Live manual Debian Live

# Debian Live Manual

# Sobre aquest manual

4

# 1. Sobre aquest manual

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

Si bé live-manual es centra principalment en ajudar a construir un sistema viu i no en temes dels usuaris finals, un usuari final pot trobar informació útil en aquestes seccions: Conceptes bàsics abasta la descàrrega d'imatges prefabricades i la preparació de les imatges per a ser arrencades des dels dispositius o la xarxa, ja sigui utilitzant el servei de construcció d'imatges web o executant live-build directament en el sistema. Personalització dels comportaments en temps d'execució descriu algunes de les opcions que es poden especificar durant l'arrencada del sistema, com ara la selecció de la disposició del teclat, la configuració regional i l'ús de la persistència.

7

Algunes de les ordres esmentades en el text s'han d'executar amb privilegis de superusuari que es poden obtenir esdevenint l'usuari root amb `su` o mitjançant l'ús de `sudo`. Per a distingir entre les ordres que poden ser executades per un usuari sense privilegis i aquelles que requereixen privilegis de superusuari, s'anteposa `$` o `#` respectivament. Aquest símbol no és part de l'ordre.

8

1.1 Per als impacients

9

Si bé creiem que tot el que hi ha en aquest manual és important, si més no, per a alguns dels nostres usuaris, ens adonem que hi ha una gran quantitat de material per a cobrir i que és possible que es vulgui experimentar l'èxit amb el programari aviat, abans d'aprofundir en els detalls. Per tant, us recomanem llegir en el següent ordre.

10

En primer lloc, llegir aquest capítol, Sobre aquest manual, des del principi i acabant amb els Termes. A continuació, saltar als tres tutorials abans dels Exemples, secció pensada per a ensenyar com fer la construcció d'una imatge i alguns aspectes bàsics de la personalització. Llegir en primer lloc Ús dels exemples seguit pel Tutorial 1: Una imatge per defecte, Tutorial 2: Una utilitat de navegador web i finalment, Tutorial 3: Una image personalitzada. Al final d'aquests tutorials, es tindrà una idea del que es pot fer amb els sistemes en viu.

11

Us animem a tornar i a fer un estudi del manual en profunditat, la propera lectura pot ser Conceptes bàsics, fregant o saltant Construir una imatge netboot, i acabant amb la lectura de la Visió general de la personalització i els capítols que segueixen. En aquest punt, esperem que estigueu ben emocionats pel que es pot fer amb els sistemes en viu i motivats per llegir la resta del manual, de principi a fi.

12

1.2 Termes

13

- Sistema viu: Un sistema operatiu que pot arrencar sense necessitat d'instal·lació en un disc dur. Els sistemes vius no alteren el sistema operatiu local(s) o els fitxer(s) ja instal·lats al disc dur de l'ordinador a menys que així se'ls ho indiqui. Els sistemes vius normalment s'inician des de dispositius, com ara CDs, DVDs o memòries USB. Alguns també poden arrencar des de la xarxa (amb les imatges netboot, veure Construir una imatge netboot), o mitjançant internet (amb el parametre `fetch=URL`, veure Webbooting).

14

- Medi en viu: A diferència de sistema en viu, el medi en viu es refereix al CD, DVD o memòria USB on es copia el fitxer binari produït per live-build i utilitzat per a arrencar el sistema en viu. Més àmpliament, el terme també es refereix a qualsevol lloc on resideix el fitxer binari als efectes d'iniciar el sistema en viu, com ara la ubicació dels fitxers per a arrencar en xarxa.

15

- Debian Live Project: El projecte que manté, entre altres, els paquets live-boot, live-build, live-config, live-tools i live-manual.

16

- Sistema amfitrió: L'entorn utilitzat per a crear el sistema en viu.

17

- Sistema objectiu: L'entorn que s'utilitza per a executar el sistema en viu.

18

- live-boot: Una col·lecció de scripts per a arrencar els sistemes vius.

19

- live-build: Una col·lecció d'scripts utilitzats per a construir sistemes en viu personalitzats.

20

- live-config: Una col·lecció de scripts utilitzats per a configurar un sistema en viu durant el procés d'arrencada.

21

- live-tools: Una col·lecció d'scripts addicionals que s'utilitzen per a realitzar tasques útils en un sistema viu en execució.

22

- live-manual: Aquest document és mantingut en un paquet anomenat live-manual

23

- Instal·lador de Debian (d-i): El sistema oficial d'instal·lació de la distribució Debian.

24

- Paràmeters d'arrencada: Els paràmetres que es poden introduir a l'indicador del carregador d'arrencada per a influir en el nucli o live-config

25

- chroot: El programa chroot, `chroot(8)`, ens permet executar diferentes instàncies d'un entorn GNU/Linux a la vegada en un sol sistema sense reiniciar.

26

- Binary image: A file containing the live system, such as live-image-amd64.hybrid.iso or live-image-amd64.img.

27

- Distribució objectiu: La distribució en què es basa el sistema en viu. Que pot diferir de la distribució del sistema amfitrió.

28

- stable/testing/unstable: La distribució stable, actualment anomenada bookworm, conté l'última distribució de Debian llençada oficialment. La distribució testing, temporalment anomenada trixie, és l'àrea d'assaig per a la pròxima versió stable. Un avantatge important de l'ús d'aquesta distribució és que té versions més recents del programari en relació amb l'edició stable. La distribució unstable, permanentment anomenada sid, és on es produeix el desenvolupament actiu de Debian. En general, aquesta distribució és utilitzada pels desenvolupadors i els que els agrada viure en risc. Al llarg del manual, es tendeix a utilitzar els seus noms en clau, com ara trixie o sid, ja que és el que fan servir les pròpies eines.

29

1.3 Autors

30

Llistat d'autors (en ordre alfabètic)

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 Contribuir a aquest document

46

Aquest manual està pensat com un projecte comunitari i totes les propostes per a millorar-lo i les contribucions són molt benvingudes. Veure la secció Contribuir al projecte per a obtenir informació detallada sobre com obtenir la clau i fer bons commits.

47

1.4.1 Aplicar canvis

48

Per tal de realitzar canvis en el manual anglès s'ha d'editar els fitxers adequats a `manual/en/` però abans de presentar una contribució, s'ha de previsualitzar el treball. Per a previsualitzar el live-manual, assegurar-se que s'han instal·lat els paquets necessaris per a la seva construcció mitjançant l'execució de:

49

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

50

Es pot crear el live-manual des del directori de nivell superior del arbre Git mitjançant l'execució de:

51

$ make build

52

Tenint en compte que es necessita un cert temps per construir el manual en tots els idiomes suportats, els autors poden utilitzar un dels mètodes abreujats per fer revisions ràpides de la nova documentació que han afegit al manual en anglès. Amb `PROOF=1` es construeix live-manual en format html, però sense els fitxers html segmentats, i amb `PROOF=2` es construeix live-manual en format pdf, però només el retrat A4 i carta. És per això que amb l'ús de qualsevol de les possibilitats `PROOF=` es pot estalviar una quantitat considerable de temps, per exemple:

53

$ make build PROOF=1

54

Quan es revisa una de les traduccions, és possible construir un sol idioma mitjançant l'execució de, per exemple:

55

$ make build LANGUAGES=de

56

També es possible crear per tipus de document, per exemple:

57

$ make build FORMATS=pdf

58

O combinar tot dos, per exemple:

59

$ make build LANGUAGES=de FORMATS=html

60

Després de revisar el treball i assegurar-se que tot està bé, no fer un `make commit` a menys que s'actualitzin les traduccions al mateix temps, i en aquest cas, no barrejar els canvis al manual anglès i les traduccions en el mateix commit, fer-ne un altre separat per a cada canvi. Veure la secció Traducció per a més detalls.

61

1.4.2 Traducció

62

Nota: Per traduir les pàgines dels manuals, veure Traducció de pàgines dels manuals

63

Per a traduir live-manual, seguir aquests passos, depenent de si s'està començant una traducció des de zero o si es segueix treballant en una ja existent:

64

- Començar una nova traducció des de zero

65

- Traduir els fitxers about_manual.ssi.pot, about_project.ssi.pot i index.html.in.pot de `manual/pot/` a la vostra llengua amb el vostre editor favorit (per exemple poedit) . Enviar els fitxers `.po` traduïts a la llista de correu per comprovar la seva integritat. La comprovació d'integritat de live-manual garanteix que els fitxers `.po` són traduïts al 100% però també detecta possibles errors.

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

- Continuar amb una traducció ja començada

68

- Una vegada que s'ha afegit la nova llengua, es pot continuar traduint la resta de fitxers .po dins de `manual/po/${LANGUAGE}/` a l'atzar amb l'editor favorit (com per exemple poedit) .

69

- No oblidar que es necessari fer un `make commit` per a garantir que els manuals traduïts s'actualitzin a partir dels fitxers .po i llavors es poden revisar els canvis executant `make build` abans de `git add .`, `git commit -m "Translating..."` i `git push`. Recordar que `make build` pot trigar una quantitat considerable de temps, però es poden revisar els idiomes de forma individual com s'explica a la secció Aplicar canvis

70

Després d'executar `make commit` es podrà veure bastant text a la pantalla. Bàsicament són missatges informatius sobre l'estat del procés i també algunes pistes sobre el que es pot fer per a millorar live-manual. Si no es veu cap error fatal, generalment es pot procedir i enviar la contribució.

71

live-manual ve amb dues utilitats que poden ser de gran ajuda pels traductors a l'hora de trobar missatges sense traduir i difusos. La primera és "make translate". Aquesta activa un script que diu en detall quants missatges sense traduir hi ha a cada fitxer .po. La segona, "make fixfuzzy", només actua sobre els missatges difusos però ajuda a trobar-los i corregir-los un per un.

72

Tenir en compte que tot i que aquestes utilitats poden ser molt útils per a fer traduccions en la línia d'ordres, l'ús d'una eina especialitzada com poedit és la manera recomanada de fer la tasca. També és una bona idea llegir la documentació de localització de debian (l10n) i, específicament dins live-manual, les Directrius per a traductors.

73

Nota: Es pot utilitzar `make clean` per a netejar l'arbre git abans de fer un push. Aquest pas no és obligatori, gràcies al fitxer .gitignore, però és una bona pràctica per a evitar enviar fitxers de forma involuntària.