Debian -->
[ document manifest ]
TOC next >>
< ^ >

Manuel Debian Live

À propos

1. À propos de ce manuel

L'objectif principal de ce manuel est servir de point d'accès unique à tous les documents liés au projet Debian Live. Tandis qu'il est principalement sur vous aider à construire un système Live et non pas sur des sujets de l'utilisateur final, un utilisateur final peut trouver des informations utiles dans ces sections: Les Bases couvrent la préparation des images pour être démarrées à partir des supports ou depuis le réseau, et Personnalisation des comportements au moment de l'exécution décrit certaines options qui peuvent être spécifiées à l'invite de démarrage, tels que la sélection d'un clavier, des paramètres régionaux, et la utilisation de la persistance.

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

1.1 Pour les impatients

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 avons fourni trois tutoriels dans la section Exemples destinée à vous apprendre la construction de l'image et les bases de la personnalisation. Lire en premier En utilisant les exemples, suivie par Tutoriel 1: Une image standard, 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 Debian Live. Nous vous encourageons à revenir à l'étude plus approfondie du manuel, la prochaine lecture peut-être Les bases, passer pour Construire une image netboot, et finissant par la lecture de la Vue d'ensemble de la personnalisation et les autres sections suivantes. En ce point, nous espérons que vous êtes complètement excités par ce que on peut faire avec Debian Live et motivés pour lire le reste du manuel, du début à la fin.

1.2 Terminologie

  • Système Live: Un système d'exploitation pouvant être démarré sans installation préalable sur 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. D'habitude, les systèmes Live sont démarrés à partir des supports tels que des CD, DVD, ou des clés USB. Certains systèmes peuvent également être démarrés depuis le réseau.
  • Debian Live: Le sous-projet Debian qui maintient les paquets live-boot, live-build, live-config, et live-manual.
  • Système Debian Live: Un système live qui utilise les logiciels du système d'exploitation Debian et qui peut être lancé depuis CD, DVD, clé USB, en réseau (à l'aide des images netboot), et à partir d'Internet (à l'aide du paramètre de démarrage fetch=URL).
  • Système hôte: L'environnement utilisé pour créer le système live.
  • Système de destination: L'environnement utilisé pour faire tourner le système live.
  • live-boot: Une collection de scripts utilisés pour lancer des systèmes live. live-boot faisait initialement partie de live-initramfs.
  • live-build: Une collection de scripts utilisés pour personnaliser les systèmes Debian Live. live-build était initialement nommé live-package, puis live-helper.
  • live-config: Une collection de scripts utilisés pour configurer un système live durant le processus de démarrage. live-config faisait initialement partie de live-initramfs.
  • live-manual: Ce document est maintenu dans un paquet nommé live-manual.
  • Debian Installer (d-i): Le système d'installation officiel pour la distribution Debian.
  • Paramètres de démarrage: Les paramètres pouvant être entrés à l'invite de démarrage afin de modifier le noyau ou live-config.
  • chroot: Le programme chroot, chroot(8), nous permet de faire tourner plusieurs instances concurrentes de l'environnement GNU/Linux sur un système sans redémarrage.
  • Image binaire: Un fichier contenant le système live, tel que binary.iso ou binary.img.
  • Distribution de destination: La distribution sur laquelle votre système live sera basée. Ceci peut varier en fonction de la distribution de votre système hôte.
  • Squeeze/Wheezy/Sid (stable/testing/unstable): Debian noms de code pour les versions. Au moment de la rédaction, Squeeze est le courant version stable et Wheezy est la version actuelle testing. Sid sera toujours synonyme de la version unstable. Tout au long du manuel, nous avons tendance à utiliser des noms de code pour les versions, car c'est ce qui est supporté par les outils eux-mêmes.
  • La distribution stable contient la dernière version officielle de Debian. La distribution testing est la future version stable où seuls 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 est en constante évolution. En général cette distribution est utilisée par les développeurs et ceux qui aiment le risque.

    1.3 Auteurs

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

  • Ben Armstrong
  • Brendan Sleight
  • Chris Lamb
  • Daniel Baumann
  • Franklin Piat
  • Jonas Stein
  • Kai Hendry
  • Marco Amadori
  • Mathieu Geli
  • Matthias Kirschner
  • Richard Nelson
  • Trent W. Buck
  • 1.4 Contribuer à ce document

    Ce manuel est conçu comme un projet communautaire et toutes les propositions d'améliorations et de contributions sont bienvenues. La meilleure façon de soumettre une contribution est de l'envoyer à la liste de diffusion. S'il vous plaît voir Contact pour plus d'informations.

    Lorsque vous soumettez une contribution, veuillez indiquer clairement le copyright et inclure la mention légale relative à la licence. Notez que pour être acceptée, la contribution doit être déposée sous la même licence que le reste du document, c'est-à-dire la GPL version 3 ou ultérieure.

    Les sources de ce manuel sont maintenues à l'aide du logiciel de gestion de versions Git. Vous pouvez obtenir la dernière copie en exécutant:

    $ git clone git://live.debian.net/git/live-manual.git

    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:

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

    Vous pouvez compiler live-manual depuis le répertoire racine de votre Git checkout en exécutant:

    $ make build

    Comme il faut un certain temps pour construire le manuel dans toutes les langues disponibles, il peut être pratique construire pour une seule langue, par exemple en exécutant:

    $ make build LANGUAGES=en

    1.4.1 Appliquer des correctifs

    Les contributions directes au référentiel sont possibles pour tout le monde. Cependant, nous vous demandons d'envoyer les changements importants sur la liste de diffusion au préalable. Afin de faire un push sur le référentiel, les étapes suivantes sont nécessaires.

  • Téléchargez la clé publique:
  • $ mkdir -p ~/.ssh/identity.d
    $ wget http://live.debian.net/other/keys/git@live.debian.net \
         -O ~/.ssh/identity.d/git@live.debian.net
    $ wget http://live.debian.net/other/keys/git@live.debian.net.pub \
         -O ~/.ssh/identity.d/git@live.debian.net.pub
    $ chmod 0600 ~/.ssh/identity.d/git@live.debian.net*

  • Ajoutez la section suivante à votre configuration openssh-client:
  • $ cat >> ~/.ssh/config << EOF
    Host live.debian.net
         Hostname live.debian.net
         User git
         IdentityFile ~/.ssh/identity.d/git@live.debian.net
    EOF

  • Clonez le manuel via ssh:
  • $ git clone git@live.debian.net:/live-manual.git
    $ cd live-manual && git checkout debian-next

  • Notez que vous devez livrer des changements sur la branche debian-next, pas sur la branche debian.
  • Après édition des fichiers dans manual/en/, veuillez appeler 'commit' dans le dossier racine du répertoire afin de nettoyer les fichier et de mettre à jour les fichiers de traduction:
  • $ make commit

  • Après nettoyage, soumettre les modifications. Veuillez écrire les commentaires de commit à l'aide de phrases complètes, en commençant par une majuscule et en terminant par un point, et en commençant par 'Fixing/Adding/Removing/Correcting/Translating', par exemple
  • $ git commit -a -m "Adding a section on applying patches."

  • Envoyez votre commit au serveur:
  • $ git push

    1.4.2 Traduction

    Pour soumettre une traduction pour une nouvelle langue, suivez ces trois étapes:

  • Traduire les fichiers about_manual.ssi.pot, about_project.ssi.pot et index.html.in.pot à votre langue avec votre éditeur préféré (comme poedit). Envoyer les fichiers traduits à la liste de diffusion. Une fois que nous avons examiné votre livraison, nous allons ajouter une nouvelle langue au manuel (avec les fichiers po) et l'activer dans l'autobuild.
  • Une fois la nouvelle langue est ajoutée, vous pouvez commencer à traduire de façon aléatoire tous les fichiers po dans manual/po/.
  • N'oubliez pas que vous devez faire un make commit pour assurer que la traduction des manuels sont mis à jour à partir des fichiers po, avant git commit -a et git push.

  • [ document manifest ]
    TOC next >>
    < ^ >