← Back to branch summary

~mfisch/ubuntu/precise/live-manual/live-manual-fix-ftbfs-831392

« back to all changes in this revision

Viewing changes to manual/fr/user_customization-overview.ssi

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Baumann, Creak, Ben Armstrong, Daniel Baumann, Richard Nelson
  • Date: 2010-11-13 16:14:33 UTC
  • mfrom: (1.1.13 upstream)
  • Revision ID: james.westby@ubuntu.com-20101113161433-j0o3i3exiuqgtzwf
Tags: 1:2.0~a10-1
[ Creak ]
* Remove fuzzy romanian translation
* Fix toc bug + tanslate last about_manual message

[ Ben Armstrong ]
* Making consistent: "foo time" instead of hyphenated alternative.
* Adding ISO hybrid.
* Rewriting virtualbox tips to focus and simplify.
* Adding tip for determining USB device.
* Fixing flow, spelling, punctuation, consistency and formatting.
* Updating language strings.
* Fixing hyphenated forms for adjectives only.
* Fixing consistent capitalization of acronyms.
* Fixing incorrect capitalization of command name.
* Updating translation strings.
* Fixing reference to a Live system as a 'CD' which is not necessarily
  the case.
* Focusing section on configuration via lb config, not by editing
  files.
* Adding more material to customization overview.
* Fixing punctuation after references, resolved in sisu 2.7.8.
* Fixing restructuring of html dir for autobuild.

[ Daniel Baumann ]
* Keeping metadata.html page in html builds.

[ Richard Nelson ]
* Add Examples/Use Cases.

[ Ben Armstrong ]
* Fixing make install should install (mostly) same files as autobuild.
* Adding background in customization overview to refer to in packages
  customization.
* Removing use cases (comment only), now moved to examples.

[ Richard Nelson ]
* Build time vs. boot time configuration, modification.

[ Ben Armstrong ]
* Fixing truncation of pdf by removing emphasis from heading.
* Adding introduction to package customization.

Show diffs side-by-side

added added

removed removed

Lines of Context:
manual/fr/user_customization-overview.ssi
2
2
 
3
3
1~customization-overview Customization overview
4
4
 
5
 
% FIXME: just a stub for now.  In conversational style, cover the different
6
 
kinds of customization % and link to each section within the text.
7
 
 
8
 
This chapter gives an overview of the various ways in which your Debian live
9
 
systems may be customized. See sections {Customizing package
 
5
This chapter gives an overview of the various ways in which you may
 
6
customize a Debian Live system.
 
7
 
 
8
2~ Build time vs. boot time configuration
 
9
 
 
10
Live system configuration options are divided into build-time options which
 
11
are options that are applied at build time and boot-time options which are
 
12
applied at boot time. Boot-time options are further divided into those
 
13
occurring early in the boot, applied by the live-boot package, and those
 
14
that happen later in the boot, applied by live-config. Any boot-time option
 
15
may be modified by the user by specifying it at the boot prompt. The image
 
16
may also be built with default boot parameters so users can normally just
 
17
boot directly to the live system without specifying any options when all of
 
18
the defaults are suitable. In particular, the argument to #{lb
 
19
--bootappend-live}# consists of any default kernel command line options for
 
20
the Live system, such as persistence, keyboard layouts, or timezone. See
 
21
{Customizing locale and language}#customizing-locale-and-language, for
 
22
example.
 
23
 
 
24
Build-time configuration options are described in the #{lb config}# man
 
25
page. Boot-time options are described in the man pages for live-boot and
 
26
live-config. Although the live-boot and live-config packages are installed
 
27
within the live system you are building, it is recommended that you also
 
28
install them on your build system for easy reference when you are working on
 
29
your configuration. It is safe to do so, as none of the scripts contained
 
30
within them are executed unless the system is configured as a live system.
 
31
 
 
32
2~stages-of-the-build Stages of the build
 
33
 
 
34
The build process is divided into stages, with various customizations
 
35
applied in sequence in each. The first stage to run is the *{bootstrap}*
 
36
stage. This is the initial phase of populating the chroot directory with
 
37
packages to make a barebones Debian system. This is followed by the
 
38
*{chroot}* stage, which completes the construction of chroot directory,
 
39
populating it with all of the packages listed in the configuration, along
 
40
with any other materials. Most customization of content occurs in this
 
41
stage. The final stage of preparing the live image is the *{binary}* stage,
 
42
which builds a bootable image, using the contents of the chroot directory to
 
43
construct the root filesystem for the Live system, and including the
 
44
installer and any other additional material on the target media outside of
 
45
the Live system's filesystem. After the live image is built, if enabled, the
 
46
source tarball is built in the *{source}* stage.
 
47
 
 
48
Within each of these stages, there is a particular sequence in which
 
49
commands are applied. These are arranged in such a way as to ensure
 
50
customizations can be layered in a reasonable fashion. For example, within
 
51
the *{chroot}* stage, preseeds are applied before any packages are
 
52
installed, packages are installed before any locally included files or
 
53
patches are applied, and hooks are run later, after all of the materials are
 
54
in place.
 
55
 
 
56
2~ Supplement lb config with files
 
57
 
 
58
Although #{lb config}# does create a skeletal configuration in the config/
 
59
directory, to accomplish your goals, you may need to provide additional
 
60
files in subdirectories of config/. Depending on where the files are stored
 
61
in the configuration, they may be copied into the live system's filesystem
 
62
or into the binary image filesystem, or may provide build-time
 
63
configurations of the system that would be cumbersome to pass as
 
64
command-line options. You may include things such as custom lists of
 
65
packages, custom artwork, or hook scripts to run either at build time or at
 
66
boot time, boosting the already considerable flexibility of debian-live with
 
67
code of your own.
 
68
 
 
69
2~ Customization tasks
 
70
 
 
71
The following chapters are organized by the kinds of customization task
 
72
users typically perform: {Customizing package
10
73
installation}#customizing-package-installation, {Customizing
11
74
contents}#customizing-contents and {Customizing locale and
12
 
language}#customizing-locale-and-language.
 
75
language}#customizing-locale-and-language cover just a few of the things you
 
76
might want to do.
13
77