Live manual Debian Live

# Debian Live Manual

# À propos de ce manuel

4

# 1. À propos de ce manuel

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

Ce manuel a principalement pour but de vous aider à construire un système live et non pas de s'articuler autour des sujets relatifs à l'utilisateur final. Toutefois, l'utilisateur final peut trouver des informations utiles dans ces sections: Les Bases couvrent le téléchargement des images précompilées et la préparation des images pour être démarrées sur les supports ou sur le réseau, soit en utilisant le constructeur web, soit en exécutant live-build directement sur le système. Personnalisation des comportements pendant l'exécution décrit certaines options qui peuvent être indiquées à l'invite de démarrage, telles que la sélection d'un clavier, des paramètres régionaux et la persistance.

7

Certaines commandes mentionnées dans le texte doivent être exécutées avec les privilèges de super-utilisateur, qui peuvent être obtenus à l'aide de la commande `su` ou en utilisant `sudo`. Afin de distinguer les commandes qui peuvent être exécutées par un utilisateur sans privilège de celles nécessitant les privilèges de super-utilisateur, les commandes sont précédées respectivement par `$` ou `#`. Notez que ce symbole ne fait pas partie de la commande.

8

1.1 Pour les impatients

9

Même si nous croyons que tout dans ce manuel est important pour au moins certains de nos utilisateurs, nous nous rendons compte qu'il y a beaucoup de matière à couvrir et que vous pouvez vouloir expérimenter avant d'entrer dans les détails. Par conséquent, nous vous suggérons de lire dans l'ordre suivant.

10

Tout d'abord, lisez ce chapitre À propos de ce manuel dès le début et finissant avec la section Terminologie. Ensuite, passez aux trois tutoriels à l'avant de la section Exemples destinée à vous apprendre la construction de l'image et les bases de la personnalisation. Lisez en premier En utilisant les exemples, puis Tutoriel 1: Une image par défaut, Tutoriel 2: Un logiciel de navigateur Web et finalement Tutoriel 3: Une image personnalisée. À la fin de ces tutoriels, vous aurez un avant-goût de ce qui peut être fait avec les systèmes live.

11

Nous vous encourageons à revenir à l'étude plus approfondie du manuel, en poursuivant par exemple votre lecture par Les bases, Construire une image netboot et finissant par la lecture de la Vue d'ensemble de la personnalisation et les sections suivantes. Après cela, nous espérons que vous serez complètement enthousiaste par ce qui peut être fait avec les systèmes live et motivés pour lire le reste du manuel, du début à la fin.

12

1.2 Terminologie

13

- Système Live: Un système d'exploitation pouvant être démarré sans installation préalable sur un disque dur. Les systèmes live ne modifient pas le système d'exploitation local ou les fichiers installés sur le disque dur sans qu'on leur en donne explicitement l'instruction. Habituellement, les systèmes live sont démarrés à partir des supports tels que des CDs, DVDs, ou des clés USB. Certains systèmes peuvent également être démarrés sur le réseau (via des images netboot, voir Construction d'une image netboot), et sur l'Internet (via le paramètre d'amorçage `fetch=URL`, voir Webbooting).

14

- Support live: À la différence du système live, le support live se réfère au CD, DVD ou clé USB où l'image binaire produite par live-build et utilisée pour démarrer le système live est écrite. D'une manière générale, le terme désigne également tout emplacement où réside l'exécutable qui permet de démarrer le système live, tel que l'emplacement des fichiers de démarrage sur le réseau.

15

- Debian Live Project: Le projet qui maintient, entre autres, les paquets live-boot, live-build, live-config live-tools et live-manual.

16

- Système hôte: L'environnement utilisé pour créer le système live.

17

- Système cible: L'environnement utilisé pour faire fonctionner le système live.

18

- live-boot: Une collection de scripts utilisés pour lancer des systèmes live.

19

- live-build: Une collection de scripts utilisés pour construire des systèmes live personnalisés.

20

- live-config: Une collection de scripts utilisés pour configurer un système live pendant le processus d'amorçage.

21

- live-tools: Une collection de scripts supplémentaires utilisés pour effectuer des tâches utiles dans un système live en fonctionnement.

22

- live-manual: Ce document est maintenu dans un paquet nommé live-manual.

23

- Debian Installer (d-i): Le système d'installation officiel pour la distribution Debian.

24

- Paramètres d'amorçage: Les paramètres qui peuvent être entrés à l'invite de démarrage afin de modifier le noyau ou live-config.

25

- chroot: Le logiciel chroot, `chroot(8)`, nous permet d'exécuter plusieurs instances concurrentes de l'environnement GNU/Linux sur un système sans redémarrage.

26

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

27

- Distribution cible: La distribution sur laquelle votre système live sera basée. Celle-ci peut être différente de la distribution de votre système hôte.

28

- stable/testing/unstable: La distribution stable, actuellement nommée bookworm, contient la dernière version officielle de Debian. La distribution testing, temporairement nommée trixie, est la prochaine version stable où seulement les paquets suffisamment matures peuvent entrer. Un avantage de cette distribution est qu'elle contient des logiciels de versions plus récentes que la version stable. La distribution unstable, nommée sid de façon permanente, est en constante évolution. En général cette distribution est utilisée par les développeurs et ceux qui aiment le risque. Tout au long du manuel, nous avons tendance à utiliser les noms de code pour les évolutions majeures, tels que trixie ou sid, car c'est ce qui est pris en charge par les outils eux-mêmes.

29

1.3 Auteurs

30

La liste des auteurs (dans l'ordre alphabétique):

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 Contribuer à ce document

46

Ce manuel est conçu comme un projet communautaire et toutes les propositions d'améliorations et de contributions sont bienvenues. Veuillez consulter la section Contribuer au projet pour des informations détaillées sur la façon d'obtenir une clé et de faire des livraisons (commits).

47

1.4.1 Appliquer des modifications

48

Afin d'apporter des modifications au manuel anglais, vous devez modifier les fichiers adéquats dans `manual/en/` mais avant de soumettre votre contribution, veuillez prévisualiser votre travail. Afin de prévisualiser live-manual, assurez-vous que les paquets nécessaires sont installés en exécutant:

49

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

50

Vous pouvez compiler live-manual dans le répertoire de niveau supérieur de votre Git checkout en exécutant:

51

$ make build

52

Comme il faut un certain temps pour construire le manual dans toutes les langues prises en charge, les auteurs peuvent trouver pratique d'utiliser l'un des raccourcis de construction rapide lors de la révision de la nouvelle documentation ajoutée au manuel anglais. `PROOF=1` construit live-manual au format html, mais sans les fichiers html segmentés, et `PROOF=2` construit live-manual au format pdf, mais seulement les portraits A4 et US. C'est pourquoi l'utilisation de l'une ou l'autre des possibilités peut sauver une quantité considérable de temps, par exemple:

53

$ make build PROOF=1

54

Lors de la révision d'une des traductions, il est possible de construire une seule langue en exécutant, par exemple:

55

$ make build LANGUAGES=de

56

Il est également possible de construire par type de document, par exemple,

57

$ make build FORMATS=pdf

58

Ou combiner les deux, par exemple:

59

$ make build LANGUAGES=de FORMATS=html

60

Après avoir relu votre travail et vous être assuré que tout va bien, n'utilisez pas `make commit` à moins que vous mettiez à jour les traductions dans le commit. Dans ce cas, ne mélangez pas les modifications apportées au manuel en anglais et les traductions dans la même livraison, mais utilisez des commits séparés. Consultez la section Traduction pour plus de détails.

61

1.4.2 Traduction

62

Note: Pour la traduction des pages de manuel, voir Traduction des pages de manuel

63

Afin de traduire live-manual, procédez comme suit, selon que vous commencez une traduction à partir de zéro ou vous travaillez sur une traduction déjà existante:

64

- Commencer une nouvelle traduction à partir de zéro

65

- Traduisez les fichiers about_manual.ssi.pot, about_project.ssi.pot et index.html.in.pot dans `manual/pot/` dans votre langue avec votre éditeur préféré (comme poedit) . Envoyez les fichiers `.po` traduits à la liste de diffusion pour vérifier leur intégrité. La vérification d'intégrité de live-manual garantit non seulement que les fichiers `.po` sont 100% traduits, mais elle détecte également des erreurs possibles.

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

- Continuer avec une traduction déjà commencée

68

- Si votre langue cible a déjà été ajoutée, vous pouvez continuer avec la traduction des fichiers .po dans `manual/po/${LANGUAGE}/` de façon aléatoire avec votre éditeur préféré (comme poedit) .

69

- N'oubliez pas que vous devez faire un `make commit` pour assurer que la traduction des manuels est mise à jour à partir des fichiers .po, alors vous pouvez réviser vos modifications avec `make build` avant `git add .`, `git commit -m "Translating..."` et `git push`. Gardez à l'esprit que `make build` peut prendre un temps considérable, vous pouvez relire les langues individuellement comme expliqué dans Appliquer des modifications

70

Après l'exécution de `make commit`, vous verrez beaucoup de texte sur l'écran. Il s'agit essentiellement de messages informatifs sur l'état du processus et de quelques indications sur ce qui peut être fait pour améliorer live-manual. Si vous ne voyez aucune erreur fatale, vous pouvez généralement continuer et soumettre votre contribution.

71

live-manual contient deux utilitaires qui peuvent grandement aider les traducteurs à trouver les textes non traduits et modifiés. Le premier est "make translate". Il lance un script qui vous indique en détail le nombre de messages non traduits qu'il y a dans chaque fichier .po. Le second, "make fixfuzzy", n'agit que sur les messages modifiés, mais il vous aide à les trouver et à les résoudre un par un.

72

Gardez à l'esprit que même si ces utilitaires peuvent être vraiment utiles pour faire un travail de traduction sur la ligne de commande, l'utilisation d'un outil spécialisé comme poedit est la méthode recommandée pour effectuer la tâche. C'est aussi une bonne idée de lire la documentation sur localisation de debian (l10n) et, plus particulièrement pour live-manual, les Lignes directrices pour les traducteurs.

73

Remarque: Vous pouvez utiliser `make clean` pour nettoyer votre arbre git avant de faire un push. Cette étape n'est pas obligatoire grâce au fichier .gitignore mais c'est une bonne pratique pour éviter d'envoyer certains fichiers involontairement.