[SCM] live-manual branch, debian, updated. debian/2.0_a10-1-11-gebcd8a6
Ben Armstrong
synrg at debian.org
Sat Nov 27 16:49:44 UTC 2010
The following commit has been merged in the debian branch:
commit ebcd8a6366ef022d28c8db6ca738e0e3b6fccd83
Author: Ben Armstrong <synrg at debian.org>
Date: Sat Nov 27 12:49:18 2010 -0400
Adding more examples: tutorial 2, minimal <128M image.
diff --git a/manual/de/user_examples.ssi b/manual/de/user_examples.ssi
index d265d54..1214813 100644
--- a/manual/de/user_examples.ssi
+++ b/manual/de/user_examples.ssi
@@ -64,20 +64,37 @@ stick}#copying-usb-hdd-image, respectively.
*{Use case}* Create a web browser utility image, learning how to apply customizations
In this tutorial, we will create an image suitable for use as a web browser
-utility using a single extra repository, a single package list, a single
-extra package, and a single extra file, configured with your locale and
-keyboard preferences, thereby introducing the various ways you can customize
-Debian Live images.
+utility, serving as an introduction to customizing Debian Live images.
-FIXME
+code{
-2~tutorial-3 Tutorial 3: A personal travelling companion
+mkdir tutorial2 ; cd tutorial2 ; lb config -p lxde --packages iceweasel
+
+}code
-*{Use case}* Create a project to build a personal travelling companion image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.
+Our choice of LXDE for this example reflects our desire to provide a minimal
+desktop environment, since the focus of the image is the single use we have
+in mind, the web browser. We could go even further and provide a default
+configuration for the web browser in
+#{config/chroot_local-includes/etc/iceweasel/profile/}#, or additional
+support packages for viewing various kinds of web content, but we leave this
+as an exercise for the reader.
+
+Build the image, keeping a log as in {Tutorial 1}#tutorial-1:
+
+code{
+
+# lb build 2>&1 | tee binary.log
+
+}code
+
+2~tutorial-3 Tutorial 3: A personalized image
+
+*{Use case}* Create a project to build a personalized image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.
FIXME
-2~ VNC Kiosk Client
+2~ A VNC Kiosk Client
Create an image with live-build to boot directly to a VNC server.
@@ -111,6 +128,50 @@ _* Build the image: #{# lb build}#
_* Enjoy.
-2~ Next Example FIXME
+2~ A base image for a 128M USB key
+
+*{Use case}* Create a standard image with some components removed in order to fit on a 128M USB key with space left over to use as you see fit.
+
+When optimizing an image to fit a certain media size, you need to understand
+the tradeoffs you are making between size and functionality. In this
+example, we trim only so much as to make room for additional material within
+a 128M media size, but without doing anything to destroy integrity of the
+packages contained within, such as the purging of locale data via the
+#{localepurge}# package, or other such "intrusive" optimizations. Of
+particular note, you should not use #{--bootstrap-flavour minimal}# unless
+you really know what you're doing, as omitting priority #{important}#
+packages will most likely produce a broken live system.
+
+code{
+
+$ lb config -k 486 -p minimal --binary-indices false --memtest none
+--apt-recommends false --includes none
+
+}code
+
+Now, build the image in the usual way:
+
+code{
+
+# lb build 2>&1 | tee binary.log
+
+}code
+On the author's system at time of writing, the above configuration produced
+a 78Mbyte image. This compares favourably with the 166Mbyte image produced
+by the default configuration in {Tutorial 1}#tutorial-1.
+
+The biggest space-saver here, compared to building a standard image on an
+#{i386}# architecture system, is to select only the #{486}# kernel flavour
+instead of the default #{-k "486 686"}#. Leaving off APT's indices with
+#{--binary-indices false}# also saves a fair amount of space, the tradeoff
+being that you need to #{apt-get update}# before using apt in the live
+system. Choosing the #{minimal}# package list leaves out the large
+#{locales}# package and associated utilities. Dropping recommended packages
+with #{--apt-recommends false}# saves some additional space, at the expense
+of omitting some packages you might otherwise expect to be there, such as
+#{firmware-linux-free}# which may be needed to support certain hardware. The
+remaining options shave off additional small amounts of space. It's up to
+you to decide if the functionality that is sacrificed with each optimization
+is worth the loss in functionality.
diff --git a/manual/en/user_examples.ssi b/manual/en/user_examples.ssi
index 38d038f..9bf8f66 100644
--- a/manual/en/user_examples.ssi
+++ b/manual/en/user_examples.ssi
@@ -45,17 +45,31 @@ Assuming all goes well, after a while, the current directory will contain #{bina
*{Use case}* Create a web browser utility image, learning how to apply customizations
-In this tutorial, we will create an image suitable for use as a web browser utility using a single extra repository, a single package list, a single extra package, and a single extra file, configured with your locale and keyboard preferences, thereby introducing the various ways you can customize Debian Live images.
+In this tutorial, we will create an image suitable for use as a web browser utility, serving as an introduction to customizing Debian Live images.
-FIXME
+code{
-2~tutorial-3 Tutorial 3: A personal travelling companion
+mkdir tutorial2 ; cd tutorial2 ; lb config -p lxde --packages iceweasel
+
+}code
-*{Use case}* Create a project to build a personal travelling companion image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.
+Our choice of LXDE for this example reflects our desire to provide a minimal desktop environment, since the focus of the image is the single use we have in mind, the web browser. We could go even further and provide a default configuration for the web browser in #{config/chroot_local-includes/etc/iceweasel/profile/}#, or additional support packages for viewing various kinds of web content, but we leave this as an exercise for the reader.
+
+Build the image, keeping a log as in {Tutorial 1}#tutorial-1:
+
+code{
+
+# lb build 2>&1 | tee binary.log
+
+}code
+
+2~tutorial-3 Tutorial 3: A personalized image
+
+*{Use case}* Create a project to build a personalized image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.
FIXME
-2~ VNC Kiosk Client
+2~ A VNC Kiosk Client
Create an image with live-build to boot directly to a VNC server.
@@ -86,6 +100,27 @@ _* Build the image: #{# lb build}#
_* Enjoy.
-2~ Next Example FIXME
+2~ A base image for a 128M USB key
+
+*{Use case}* Create a standard image with some components removed in order to fit on a 128M USB key with space left over to use as you see fit.
+
+When optimizing an image to fit a certain media size, you need to understand the tradeoffs you are making between size and functionality. In this example, we trim only so much as to make room for additional material within a 128M media size, but without doing anything to destroy integrity of the packages contained within, such as the purging of locale data via the #{localepurge}# package, or other such "intrusive" optimizations. Of particular note, you should not use #{--bootstrap-flavour minimal}# unless you really know what you're doing, as omitting priority #{important}# packages will most likely produce a broken live system.
+
+code{
+
+$ lb config -k 486 -p minimal --binary-indices false --memtest none --apt-recommends false --includes none
+
+}code
+
+Now, build the image in the usual way:
+
+code{
+
+# lb build 2>&1 | tee binary.log
+
+}code
+
+On the author's system at time of writing, the above configuration produced a 78Mbyte image. This compares favourably with the 166Mbyte image produced by the default configuration in {Tutorial 1}#tutorial-1.
+The biggest space-saver here, compared to building a standard image on an #{i386}# architecture system, is to select only the #{486}# kernel flavour instead of the default #{-k "486 686"}#. Leaving off APT's indices with #{--binary-indices false}# also saves a fair amount of space, the tradeoff being that you need to #{apt-get update}# before using apt in the live system. Choosing the #{minimal}# package list leaves out the large #{locales}# package and associated utilities. Dropping recommended packages with #{--apt-recommends false}# saves some additional space, at the expense of omitting some packages you might otherwise expect to be there, such as #{firmware-linux-free}# which may be needed to support certain hardware. The remaining options shave off additional small amounts of space. It's up to you to decide if the functionality that is sacrificed with each optimization is worth the loss in functionality.
diff --git a/manual/fr/user_examples.ssi b/manual/fr/user_examples.ssi
index d265d54..1214813 100644
--- a/manual/fr/user_examples.ssi
+++ b/manual/fr/user_examples.ssi
@@ -64,20 +64,37 @@ stick}#copying-usb-hdd-image, respectively.
*{Use case}* Create a web browser utility image, learning how to apply customizations
In this tutorial, we will create an image suitable for use as a web browser
-utility using a single extra repository, a single package list, a single
-extra package, and a single extra file, configured with your locale and
-keyboard preferences, thereby introducing the various ways you can customize
-Debian Live images.
+utility, serving as an introduction to customizing Debian Live images.
-FIXME
+code{
-2~tutorial-3 Tutorial 3: A personal travelling companion
+mkdir tutorial2 ; cd tutorial2 ; lb config -p lxde --packages iceweasel
+
+}code
-*{Use case}* Create a project to build a personal travelling companion image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.
+Our choice of LXDE for this example reflects our desire to provide a minimal
+desktop environment, since the focus of the image is the single use we have
+in mind, the web browser. We could go even further and provide a default
+configuration for the web browser in
+#{config/chroot_local-includes/etc/iceweasel/profile/}#, or additional
+support packages for viewing various kinds of web content, but we leave this
+as an exercise for the reader.
+
+Build the image, keeping a log as in {Tutorial 1}#tutorial-1:
+
+code{
+
+# lb build 2>&1 | tee binary.log
+
+}code
+
+2~tutorial-3 Tutorial 3: A personalized image
+
+*{Use case}* Create a project to build a personalized image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.
FIXME
-2~ VNC Kiosk Client
+2~ A VNC Kiosk Client
Create an image with live-build to boot directly to a VNC server.
@@ -111,6 +128,50 @@ _* Build the image: #{# lb build}#
_* Enjoy.
-2~ Next Example FIXME
+2~ A base image for a 128M USB key
+
+*{Use case}* Create a standard image with some components removed in order to fit on a 128M USB key with space left over to use as you see fit.
+
+When optimizing an image to fit a certain media size, you need to understand
+the tradeoffs you are making between size and functionality. In this
+example, we trim only so much as to make room for additional material within
+a 128M media size, but without doing anything to destroy integrity of the
+packages contained within, such as the purging of locale data via the
+#{localepurge}# package, or other such "intrusive" optimizations. Of
+particular note, you should not use #{--bootstrap-flavour minimal}# unless
+you really know what you're doing, as omitting priority #{important}#
+packages will most likely produce a broken live system.
+
+code{
+
+$ lb config -k 486 -p minimal --binary-indices false --memtest none
+--apt-recommends false --includes none
+
+}code
+
+Now, build the image in the usual way:
+
+code{
+
+# lb build 2>&1 | tee binary.log
+
+}code
+On the author's system at time of writing, the above configuration produced
+a 78Mbyte image. This compares favourably with the 166Mbyte image produced
+by the default configuration in {Tutorial 1}#tutorial-1.
+
+The biggest space-saver here, compared to building a standard image on an
+#{i386}# architecture system, is to select only the #{486}# kernel flavour
+instead of the default #{-k "486 686"}#. Leaving off APT's indices with
+#{--binary-indices false}# also saves a fair amount of space, the tradeoff
+being that you need to #{apt-get update}# before using apt in the live
+system. Choosing the #{minimal}# package list leaves out the large
+#{locales}# package and associated utilities. Dropping recommended packages
+with #{--apt-recommends false}# saves some additional space, at the expense
+of omitting some packages you might otherwise expect to be there, such as
+#{firmware-linux-free}# which may be needed to support certain hardware. The
+remaining options shave off additional small amounts of space. It's up to
+you to decide if the functionality that is sacrificed with each optimization
+is worth the loss in functionality.
diff --git a/manual/po/de/user_examples.ssi.po b/manual/po/de/user_examples.ssi.po
index 25db497..7e40a9f 100644
--- a/manual/po/de/user_examples.ssi.po
+++ b/manual/po/de/user_examples.ssi.po
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-11-27 09:40-0400\n"
+"POT-Creation-Date: 2010-11-27 12:48-0400\n"
"PO-Revision-Date: 2010-11-04 16:34-0400\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -66,12 +66,14 @@ msgstr ""
#: en/user_customization-packages.ssi:261
#: en/user_customization-packages.ssi:273
#: en/user_customization-packages.ssi:283 en/user_examples.ssi:12
-#: en/user_examples.ssi:27 en/user_examples.ssi:37 en/user_examples.ssi:75
-#: en/user_installation.ssi:38 en/user_installation.ssi:46
-#: en/user_installation.ssi:56 en/user_installation.ssi:64
-#: en/user_installation.ssi:76 en/user_installation.ssi:84
-#: en/user_installation.ssi:104 en/user_installation.ssi:118
-#: en/user_installation.ssi:135 en/user_managing_a_configuration.ssi:24
+#: en/user_examples.ssi:27 en/user_examples.ssi:37 en/user_examples.ssi:51
+#: en/user_examples.ssi:61 en/user_examples.ssi:89 en/user_examples.ssi:110
+#: en/user_examples.ssi:118 en/user_installation.ssi:38
+#: en/user_installation.ssi:46 en/user_installation.ssi:56
+#: en/user_installation.ssi:64 en/user_installation.ssi:76
+#: en/user_installation.ssi:84 en/user_installation.ssi:104
+#: en/user_installation.ssi:118 en/user_installation.ssi:135
+#: en/user_managing_a_configuration.ssi:24
#: en/user_managing_a_configuration.ssi:35
#: en/user_managing_a_configuration.ssi:47 en/user_overview.ssi:36
#: en/user_overview.ssi:80 en/user_overview.ssi:88
@@ -128,12 +130,14 @@ msgstr ""
#: en/user_customization-packages.ssi:265
#: en/user_customization-packages.ssi:277
#: en/user_customization-packages.ssi:287 en/user_examples.ssi:17
-#: en/user_examples.ssi:31 en/user_examples.ssi:41 en/user_examples.ssi:84
-#: en/user_installation.ssi:42 en/user_installation.ssi:50
-#: en/user_installation.ssi:60 en/user_installation.ssi:72
-#: en/user_installation.ssi:80 en/user_installation.ssi:88
-#: en/user_installation.ssi:108 en/user_installation.ssi:123
-#: en/user_installation.ssi:138 en/user_managing_a_configuration.ssi:31
+#: en/user_examples.ssi:31 en/user_examples.ssi:41 en/user_examples.ssi:55
+#: en/user_examples.ssi:65 en/user_examples.ssi:98 en/user_examples.ssi:114
+#: en/user_examples.ssi:122 en/user_installation.ssi:42
+#: en/user_installation.ssi:50 en/user_installation.ssi:60
+#: en/user_installation.ssi:72 en/user_installation.ssi:80
+#: en/user_installation.ssi:88 en/user_installation.ssi:108
+#: en/user_installation.ssi:123 en/user_installation.ssi:138
+#: en/user_managing_a_configuration.ssi:31
#: en/user_managing_a_configuration.ssi:43
#: en/user_managing_a_configuration.ssi:52 en/user_overview.ssi:74
#: en/user_overview.ssi:84 en/user_overview.ssi:92
@@ -145,13 +149,12 @@ msgstr ""
#: en/other_customization-bootup.ssi:56 en/other_customization-bootup.ssi:60
#: en/other_customization-bootup.ssi:64 en/other_customization-bootup.ssi:68
#: en/other_live-environment.ssi:8 en/other_resources.ssi:8
-#: en/other_success-stories.ssi:7 en/user_examples.ssi:51
-#: en/user_examples.ssi:57
+#: en/other_success-stories.ssi:7 en/user_examples.ssi:71
msgid "FIXME"
msgstr ""
#. type: Plain text
-#: en/other_faq.ssi:85 en/other_faq.ssi:247 en/user_examples.ssi:77
+#: en/other_faq.ssi:85 en/other_faq.ssi:247 en/user_examples.ssi:91
msgid "#!/bin/sh"
msgstr ""
@@ -272,92 +275,173 @@ msgstr ""
#: en/user_examples.ssi:49
msgid ""
"In this tutorial, we will create an image suitable for use as a web browser "
-"utility using a single extra repository, a single package list, a single "
-"extra package, and a single extra file, configured with your locale and "
-"keyboard preferences, thereby introducing the various ways you can customize "
-"Debian Live images."
+"utility, serving as an introduction to customizing Debian Live images."
msgstr ""
#. type: Plain text
#: en/user_examples.ssi:53
-msgid "2~tutorial-3 Tutorial 3: A personal travelling companion"
+msgid "mkdir tutorial2 ; cd tutorial2 ; lb config -p lxde --packages iceweasel"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:55
-#, no-wrap
-msgid "*{Use case}* Create a project to build a personal travelling companion image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.\n"
+#: en/user_examples.ssi:57
+msgid ""
+"Our choice of LXDE for this example reflects our desire to provide a minimal "
+"desktop environment, since the focus of the image is the single use we have "
+"in mind, the web browser. We could go even further and provide a default "
+"configuration for the web browser in #{config/chroot_local-includes/etc/"
+"iceweasel/profile/}#, or additional support packages for viewing various "
+"kinds of web content, but we leave this as an exercise for the reader."
msgstr ""
#. type: Plain text
#: en/user_examples.ssi:59
-msgid "2~ VNC Kiosk Client"
+msgid "Build the image, keeping a log as in {Tutorial 1}#tutorial-1:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:63 en/user_examples.ssi:120
+msgid "# lb build 2>&1 | tee binary.log"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:67
+msgid "2~tutorial-3 Tutorial 3: A personalized image"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:61
+#: en/user_examples.ssi:69
+#, no-wrap
+msgid "*{Use case}* Create a project to build a personalized image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:73
+msgid "2~ A VNC Kiosk Client"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:75
msgid "Create an image with live-build to boot directly to a VNC server."
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:63
+#: en/user_examples.ssi:77
msgid "_* Make a build directory: #{$ mkdir vncBuild}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:65
+#: en/user_examples.ssi:79
msgid "_* Move to the build directory: #{$ cd vncBuild}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:67
+#: en/user_examples.ssi:81
msgid ""
"Example to config the build directory to include gdm metacity "
"xtightvncviewer: #{$ lb config --packages \"gdm3 metacity xtightvncviewer\"}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:69
+#: en/user_examples.ssi:83
msgid ""
"Create a folder /etc/skel folder for a custom .xsession for the default "
"user: #{$ mkdir -p config/chroot_local-includes/etc/skel}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:71
+#: en/user_examples.ssi:85
msgid ""
"Create the .xsession for the default user: #{$ touch config/chroot_local-"
"includes/etc/skel/.xsession}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:73
+#: en/user_examples.ssi:87
msgid ""
"Edit the .xsession file to launch metacity and start xvncviewer with "
"something similar to the below:"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:80
+#: en/user_examples.ssi:94
msgid "/usr/bin/metacity & /usr/bin/vncviewer xxx.xxx.xxx.xxx:PORT"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:82
+#: en/user_examples.ssi:96
msgid "exit"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:86
+#: en/user_examples.ssi:100
msgid "_* Build the image: #{# lb build}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:88
+#: en/user_examples.ssi:102
msgid "_* Enjoy."
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:90
-msgid "2~ Next Example FIXME"
+#: en/user_examples.ssi:104
+msgid "2~ A base image for a 128M USB key"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:106
+#, no-wrap
+msgid "*{Use case}* Create a standard image with some components removed in order to fit on a 128M USB key with space left over to use as you see fit.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:108
+msgid ""
+"When optimizing an image to fit a certain media size, you need to understand "
+"the tradeoffs you are making between size and functionality. In this "
+"example, we trim only so much as to make room for additional material within "
+"a 128M media size, but without doing anything to destroy integrity of the "
+"packages contained within, such as the purging of locale data via the #"
+"{localepurge}# package, or other such \"intrusive\" optimizations. Of "
+"particular note, you should not use #{--bootstrap-flavour minimal}# unless "
+"you really know what you're doing, as omitting priority #{important}# "
+"packages will most likely produce a broken live system."
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:112
+msgid ""
+"$ lb config -k 486 -p minimal --binary-indices false --memtest none --apt-"
+"recommends false --includes none"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:116
+msgid "Now, build the image in the usual way:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:124
+msgid ""
+"On the author's system at time of writing, the above configuration produced "
+"a 78Mbyte image. This compares favourably with the 166Mbyte image produced "
+"by the default configuration in {Tutorial 1}#tutorial-1."
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:126
+msgid ""
+"The biggest space-saver here, compared to building a standard image on an #"
+"{i386}# architecture system, is to select only the #{486}# kernel flavour "
+"instead of the default #{-k \"486 686\"}#. Leaving off APT's indices with #"
+"{--binary-indices false}# also saves a fair amount of space, the tradeoff "
+"being that you need to #{apt-get update}# before using apt in the live "
+"system. Choosing the #{minimal}# package list leaves out the large #{locales}"
+"# package and associated utilities. Dropping recommended packages with #{--"
+"apt-recommends false}# saves some additional space, at the expense of "
+"omitting some packages you might otherwise expect to be there, such as #"
+"{firmware-linux-free}# which may be needed to support certain hardware. The "
+"remaining options shave off additional small amounts of space. It's up to "
+"you to decide if the functionality that is sacrificed with each optimization "
+"is worth the loss in functionality."
msgstr ""
diff --git a/manual/po/fr/user_examples.ssi.po b/manual/po/fr/user_examples.ssi.po
index ff41674..be7ad81 100644
--- a/manual/po/fr/user_examples.ssi.po
+++ b/manual/po/fr/user_examples.ssi.po
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-11-27 09:40-0400\n"
+"POT-Creation-Date: 2010-11-27 12:48-0400\n"
"PO-Revision-Date: 2010-11-04 16:34-0400\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -66,12 +66,14 @@ msgstr ""
#: en/user_customization-packages.ssi:261
#: en/user_customization-packages.ssi:273
#: en/user_customization-packages.ssi:283 en/user_examples.ssi:12
-#: en/user_examples.ssi:27 en/user_examples.ssi:37 en/user_examples.ssi:75
-#: en/user_installation.ssi:38 en/user_installation.ssi:46
-#: en/user_installation.ssi:56 en/user_installation.ssi:64
-#: en/user_installation.ssi:76 en/user_installation.ssi:84
-#: en/user_installation.ssi:104 en/user_installation.ssi:118
-#: en/user_installation.ssi:135 en/user_managing_a_configuration.ssi:24
+#: en/user_examples.ssi:27 en/user_examples.ssi:37 en/user_examples.ssi:51
+#: en/user_examples.ssi:61 en/user_examples.ssi:89 en/user_examples.ssi:110
+#: en/user_examples.ssi:118 en/user_installation.ssi:38
+#: en/user_installation.ssi:46 en/user_installation.ssi:56
+#: en/user_installation.ssi:64 en/user_installation.ssi:76
+#: en/user_installation.ssi:84 en/user_installation.ssi:104
+#: en/user_installation.ssi:118 en/user_installation.ssi:135
+#: en/user_managing_a_configuration.ssi:24
#: en/user_managing_a_configuration.ssi:35
#: en/user_managing_a_configuration.ssi:47 en/user_overview.ssi:36
#: en/user_overview.ssi:80 en/user_overview.ssi:88
@@ -128,12 +130,14 @@ msgstr "code{"
#: en/user_customization-packages.ssi:265
#: en/user_customization-packages.ssi:277
#: en/user_customization-packages.ssi:287 en/user_examples.ssi:17
-#: en/user_examples.ssi:31 en/user_examples.ssi:41 en/user_examples.ssi:84
-#: en/user_installation.ssi:42 en/user_installation.ssi:50
-#: en/user_installation.ssi:60 en/user_installation.ssi:72
-#: en/user_installation.ssi:80 en/user_installation.ssi:88
-#: en/user_installation.ssi:108 en/user_installation.ssi:123
-#: en/user_installation.ssi:138 en/user_managing_a_configuration.ssi:31
+#: en/user_examples.ssi:31 en/user_examples.ssi:41 en/user_examples.ssi:55
+#: en/user_examples.ssi:65 en/user_examples.ssi:98 en/user_examples.ssi:114
+#: en/user_examples.ssi:122 en/user_installation.ssi:42
+#: en/user_installation.ssi:50 en/user_installation.ssi:60
+#: en/user_installation.ssi:72 en/user_installation.ssi:80
+#: en/user_installation.ssi:88 en/user_installation.ssi:108
+#: en/user_installation.ssi:123 en/user_installation.ssi:138
+#: en/user_managing_a_configuration.ssi:31
#: en/user_managing_a_configuration.ssi:43
#: en/user_managing_a_configuration.ssi:52 en/user_overview.ssi:74
#: en/user_overview.ssi:84 en/user_overview.ssi:92
@@ -145,13 +149,12 @@ msgstr "}code"
#: en/other_customization-bootup.ssi:56 en/other_customization-bootup.ssi:60
#: en/other_customization-bootup.ssi:64 en/other_customization-bootup.ssi:68
#: en/other_live-environment.ssi:8 en/other_resources.ssi:8
-#: en/other_success-stories.ssi:7 en/user_examples.ssi:51
-#: en/user_examples.ssi:57
+#: en/other_success-stories.ssi:7 en/user_examples.ssi:71
msgid "FIXME"
msgstr ""
#. type: Plain text
-#: en/other_faq.ssi:85 en/other_faq.ssi:247 en/user_examples.ssi:77
+#: en/other_faq.ssi:85 en/other_faq.ssi:247 en/user_examples.ssi:91
msgid "#!/bin/sh"
msgstr ""
@@ -272,92 +275,173 @@ msgstr ""
#: en/user_examples.ssi:49
msgid ""
"In this tutorial, we will create an image suitable for use as a web browser "
-"utility using a single extra repository, a single package list, a single "
-"extra package, and a single extra file, configured with your locale and "
-"keyboard preferences, thereby introducing the various ways you can customize "
-"Debian Live images."
+"utility, serving as an introduction to customizing Debian Live images."
msgstr ""
#. type: Plain text
#: en/user_examples.ssi:53
-msgid "2~tutorial-3 Tutorial 3: A personal travelling companion"
+msgid "mkdir tutorial2 ; cd tutorial2 ; lb config -p lxde --packages iceweasel"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:55
-#, no-wrap
-msgid "*{Use case}* Create a project to build a personal travelling companion image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.\n"
+#: en/user_examples.ssi:57
+msgid ""
+"Our choice of LXDE for this example reflects our desire to provide a minimal "
+"desktop environment, since the focus of the image is the single use we have "
+"in mind, the web browser. We could go even further and provide a default "
+"configuration for the web browser in #{config/chroot_local-includes/etc/"
+"iceweasel/profile/}#, or additional support packages for viewing various "
+"kinds of web content, but we leave this as an exercise for the reader."
msgstr ""
#. type: Plain text
#: en/user_examples.ssi:59
-msgid "2~ VNC Kiosk Client"
+msgid "Build the image, keeping a log as in {Tutorial 1}#tutorial-1:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:63 en/user_examples.ssi:120
+msgid "# lb build 2>&1 | tee binary.log"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:67
+msgid "2~tutorial-3 Tutorial 3: A personalized image"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:61
+#: en/user_examples.ssi:69
+#, no-wrap
+msgid "*{Use case}* Create a project to build a personalized image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:73
+msgid "2~ A VNC Kiosk Client"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:75
msgid "Create an image with live-build to boot directly to a VNC server."
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:63
+#: en/user_examples.ssi:77
msgid "_* Make a build directory: #{$ mkdir vncBuild}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:65
+#: en/user_examples.ssi:79
msgid "_* Move to the build directory: #{$ cd vncBuild}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:67
+#: en/user_examples.ssi:81
msgid ""
"Example to config the build directory to include gdm metacity "
"xtightvncviewer: #{$ lb config --packages \"gdm3 metacity xtightvncviewer\"}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:69
+#: en/user_examples.ssi:83
msgid ""
"Create a folder /etc/skel folder for a custom .xsession for the default "
"user: #{$ mkdir -p config/chroot_local-includes/etc/skel}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:71
+#: en/user_examples.ssi:85
msgid ""
"Create the .xsession for the default user: #{$ touch config/chroot_local-"
"includes/etc/skel/.xsession}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:73
+#: en/user_examples.ssi:87
msgid ""
"Edit the .xsession file to launch metacity and start xvncviewer with "
"something similar to the below:"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:80
+#: en/user_examples.ssi:94
msgid "/usr/bin/metacity & /usr/bin/vncviewer xxx.xxx.xxx.xxx:PORT"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:82
+#: en/user_examples.ssi:96
msgid "exit"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:86
+#: en/user_examples.ssi:100
msgid "_* Build the image: #{# lb build}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:88
+#: en/user_examples.ssi:102
msgid "_* Enjoy."
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:90
-msgid "2~ Next Example FIXME"
+#: en/user_examples.ssi:104
+msgid "2~ A base image for a 128M USB key"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:106
+#, no-wrap
+msgid "*{Use case}* Create a standard image with some components removed in order to fit on a 128M USB key with space left over to use as you see fit.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:108
+msgid ""
+"When optimizing an image to fit a certain media size, you need to understand "
+"the tradeoffs you are making between size and functionality. In this "
+"example, we trim only so much as to make room for additional material within "
+"a 128M media size, but without doing anything to destroy integrity of the "
+"packages contained within, such as the purging of locale data via the #"
+"{localepurge}# package, or other such \"intrusive\" optimizations. Of "
+"particular note, you should not use #{--bootstrap-flavour minimal}# unless "
+"you really know what you're doing, as omitting priority #{important}# "
+"packages will most likely produce a broken live system."
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:112
+msgid ""
+"$ lb config -k 486 -p minimal --binary-indices false --memtest none --apt-"
+"recommends false --includes none"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:116
+msgid "Now, build the image in the usual way:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:124
+msgid ""
+"On the author's system at time of writing, the above configuration produced "
+"a 78Mbyte image. This compares favourably with the 166Mbyte image produced "
+"by the default configuration in {Tutorial 1}#tutorial-1."
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:126
+msgid ""
+"The biggest space-saver here, compared to building a standard image on an #"
+"{i386}# architecture system, is to select only the #{486}# kernel flavour "
+"instead of the default #{-k \"486 686\"}#. Leaving off APT's indices with #"
+"{--binary-indices false}# also saves a fair amount of space, the tradeoff "
+"being that you need to #{apt-get update}# before using apt in the live "
+"system. Choosing the #{minimal}# package list leaves out the large #{locales}"
+"# package and associated utilities. Dropping recommended packages with #{--"
+"apt-recommends false}# saves some additional space, at the expense of "
+"omitting some packages you might otherwise expect to be there, such as #"
+"{firmware-linux-free}# which may be needed to support certain hardware. The "
+"remaining options shave off additional small amounts of space. It's up to "
+"you to decide if the functionality that is sacrificed with each optimization "
+"is worth the loss in functionality."
msgstr ""
diff --git a/manual/po/pt_BR/user_examples.ssi.po b/manual/po/pt_BR/user_examples.ssi.po
index accfde6..138b81e 100644
--- a/manual/po/pt_BR/user_examples.ssi.po
+++ b/manual/po/pt_BR/user_examples.ssi.po
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-11-27 09:40-0400\n"
+"POT-Creation-Date: 2010-11-27 12:48-0400\n"
"PO-Revision-Date: 2010-11-04 16:34-0400\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -66,12 +66,14 @@ msgstr ""
#: en/user_customization-packages.ssi:261
#: en/user_customization-packages.ssi:273
#: en/user_customization-packages.ssi:283 en/user_examples.ssi:12
-#: en/user_examples.ssi:27 en/user_examples.ssi:37 en/user_examples.ssi:75
-#: en/user_installation.ssi:38 en/user_installation.ssi:46
-#: en/user_installation.ssi:56 en/user_installation.ssi:64
-#: en/user_installation.ssi:76 en/user_installation.ssi:84
-#: en/user_installation.ssi:104 en/user_installation.ssi:118
-#: en/user_installation.ssi:135 en/user_managing_a_configuration.ssi:24
+#: en/user_examples.ssi:27 en/user_examples.ssi:37 en/user_examples.ssi:51
+#: en/user_examples.ssi:61 en/user_examples.ssi:89 en/user_examples.ssi:110
+#: en/user_examples.ssi:118 en/user_installation.ssi:38
+#: en/user_installation.ssi:46 en/user_installation.ssi:56
+#: en/user_installation.ssi:64 en/user_installation.ssi:76
+#: en/user_installation.ssi:84 en/user_installation.ssi:104
+#: en/user_installation.ssi:118 en/user_installation.ssi:135
+#: en/user_managing_a_configuration.ssi:24
#: en/user_managing_a_configuration.ssi:35
#: en/user_managing_a_configuration.ssi:47 en/user_overview.ssi:36
#: en/user_overview.ssi:80 en/user_overview.ssi:88
@@ -128,12 +130,14 @@ msgstr "code{"
#: en/user_customization-packages.ssi:265
#: en/user_customization-packages.ssi:277
#: en/user_customization-packages.ssi:287 en/user_examples.ssi:17
-#: en/user_examples.ssi:31 en/user_examples.ssi:41 en/user_examples.ssi:84
-#: en/user_installation.ssi:42 en/user_installation.ssi:50
-#: en/user_installation.ssi:60 en/user_installation.ssi:72
-#: en/user_installation.ssi:80 en/user_installation.ssi:88
-#: en/user_installation.ssi:108 en/user_installation.ssi:123
-#: en/user_installation.ssi:138 en/user_managing_a_configuration.ssi:31
+#: en/user_examples.ssi:31 en/user_examples.ssi:41 en/user_examples.ssi:55
+#: en/user_examples.ssi:65 en/user_examples.ssi:98 en/user_examples.ssi:114
+#: en/user_examples.ssi:122 en/user_installation.ssi:42
+#: en/user_installation.ssi:50 en/user_installation.ssi:60
+#: en/user_installation.ssi:72 en/user_installation.ssi:80
+#: en/user_installation.ssi:88 en/user_installation.ssi:108
+#: en/user_installation.ssi:123 en/user_installation.ssi:138
+#: en/user_managing_a_configuration.ssi:31
#: en/user_managing_a_configuration.ssi:43
#: en/user_managing_a_configuration.ssi:52 en/user_overview.ssi:74
#: en/user_overview.ssi:84 en/user_overview.ssi:92
@@ -145,13 +149,12 @@ msgstr "}code"
#: en/other_customization-bootup.ssi:56 en/other_customization-bootup.ssi:60
#: en/other_customization-bootup.ssi:64 en/other_customization-bootup.ssi:68
#: en/other_live-environment.ssi:8 en/other_resources.ssi:8
-#: en/other_success-stories.ssi:7 en/user_examples.ssi:51
-#: en/user_examples.ssi:57
+#: en/other_success-stories.ssi:7 en/user_examples.ssi:71
msgid "FIXME"
msgstr ""
#. type: Plain text
-#: en/other_faq.ssi:85 en/other_faq.ssi:247 en/user_examples.ssi:77
+#: en/other_faq.ssi:85 en/other_faq.ssi:247 en/user_examples.ssi:91
msgid "#!/bin/sh"
msgstr ""
@@ -272,92 +275,173 @@ msgstr ""
#: en/user_examples.ssi:49
msgid ""
"In this tutorial, we will create an image suitable for use as a web browser "
-"utility using a single extra repository, a single package list, a single "
-"extra package, and a single extra file, configured with your locale and "
-"keyboard preferences, thereby introducing the various ways you can customize "
-"Debian Live images."
+"utility, serving as an introduction to customizing Debian Live images."
msgstr ""
#. type: Plain text
#: en/user_examples.ssi:53
-msgid "2~tutorial-3 Tutorial 3: A personal travelling companion"
+msgid "mkdir tutorial2 ; cd tutorial2 ; lb config -p lxde --packages iceweasel"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:55
-#, no-wrap
-msgid "*{Use case}* Create a project to build a personal travelling companion image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.\n"
+#: en/user_examples.ssi:57
+msgid ""
+"Our choice of LXDE for this example reflects our desire to provide a minimal "
+"desktop environment, since the focus of the image is the single use we have "
+"in mind, the web browser. We could go even further and provide a default "
+"configuration for the web browser in #{config/chroot_local-includes/etc/"
+"iceweasel/profile/}#, or additional support packages for viewing various "
+"kinds of web content, but we leave this as an exercise for the reader."
msgstr ""
#. type: Plain text
#: en/user_examples.ssi:59
-msgid "2~ VNC Kiosk Client"
+msgid "Build the image, keeping a log as in {Tutorial 1}#tutorial-1:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:63 en/user_examples.ssi:120
+msgid "# lb build 2>&1 | tee binary.log"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:67
+msgid "2~tutorial-3 Tutorial 3: A personalized image"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:61
+#: en/user_examples.ssi:69
+#, no-wrap
+msgid "*{Use case}* Create a project to build a personalized image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:73
+msgid "2~ A VNC Kiosk Client"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:75
msgid "Create an image with live-build to boot directly to a VNC server."
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:63
+#: en/user_examples.ssi:77
msgid "_* Make a build directory: #{$ mkdir vncBuild}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:65
+#: en/user_examples.ssi:79
msgid "_* Move to the build directory: #{$ cd vncBuild}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:67
+#: en/user_examples.ssi:81
msgid ""
"Example to config the build directory to include gdm metacity "
"xtightvncviewer: #{$ lb config --packages \"gdm3 metacity xtightvncviewer\"}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:69
+#: en/user_examples.ssi:83
msgid ""
"Create a folder /etc/skel folder for a custom .xsession for the default "
"user: #{$ mkdir -p config/chroot_local-includes/etc/skel}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:71
+#: en/user_examples.ssi:85
msgid ""
"Create the .xsession for the default user: #{$ touch config/chroot_local-"
"includes/etc/skel/.xsession}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:73
+#: en/user_examples.ssi:87
msgid ""
"Edit the .xsession file to launch metacity and start xvncviewer with "
"something similar to the below:"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:80
+#: en/user_examples.ssi:94
msgid "/usr/bin/metacity & /usr/bin/vncviewer xxx.xxx.xxx.xxx:PORT"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:82
+#: en/user_examples.ssi:96
msgid "exit"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:86
+#: en/user_examples.ssi:100
msgid "_* Build the image: #{# lb build}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:88
+#: en/user_examples.ssi:102
msgid "_* Enjoy."
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:90
-msgid "2~ Next Example FIXME"
+#: en/user_examples.ssi:104
+msgid "2~ A base image for a 128M USB key"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:106
+#, no-wrap
+msgid "*{Use case}* Create a standard image with some components removed in order to fit on a 128M USB key with space left over to use as you see fit.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:108
+msgid ""
+"When optimizing an image to fit a certain media size, you need to understand "
+"the tradeoffs you are making between size and functionality. In this "
+"example, we trim only so much as to make room for additional material within "
+"a 128M media size, but without doing anything to destroy integrity of the "
+"packages contained within, such as the purging of locale data via the #"
+"{localepurge}# package, or other such \"intrusive\" optimizations. Of "
+"particular note, you should not use #{--bootstrap-flavour minimal}# unless "
+"you really know what you're doing, as omitting priority #{important}# "
+"packages will most likely produce a broken live system."
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:112
+msgid ""
+"$ lb config -k 486 -p minimal --binary-indices false --memtest none --apt-"
+"recommends false --includes none"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:116
+msgid "Now, build the image in the usual way:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:124
+msgid ""
+"On the author's system at time of writing, the above configuration produced "
+"a 78Mbyte image. This compares favourably with the 166Mbyte image produced "
+"by the default configuration in {Tutorial 1}#tutorial-1."
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:126
+msgid ""
+"The biggest space-saver here, compared to building a standard image on an #"
+"{i386}# architecture system, is to select only the #{486}# kernel flavour "
+"instead of the default #{-k \"486 686\"}#. Leaving off APT's indices with #"
+"{--binary-indices false}# also saves a fair amount of space, the tradeoff "
+"being that you need to #{apt-get update}# before using apt in the live "
+"system. Choosing the #{minimal}# package list leaves out the large #{locales}"
+"# package and associated utilities. Dropping recommended packages with #{--"
+"apt-recommends false}# saves some additional space, at the expense of "
+"omitting some packages you might otherwise expect to be there, such as #"
+"{firmware-linux-free}# which may be needed to support certain hardware. The "
+"remaining options shave off additional small amounts of space. It's up to "
+"you to decide if the functionality that is sacrificed with each optimization "
+"is worth the loss in functionality."
msgstr ""
diff --git a/manual/po/ro/user_examples.ssi.po b/manual/po/ro/user_examples.ssi.po
index 5a8d7b4..9192984 100644
--- a/manual/po/ro/user_examples.ssi.po
+++ b/manual/po/ro/user_examples.ssi.po
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-11-27 09:40-0400\n"
+"POT-Creation-Date: 2010-11-27 12:48-0400\n"
"PO-Revision-Date: 2010-11-04 16:34-0400\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -67,12 +67,14 @@ msgstr ""
#: en/user_customization-packages.ssi:261
#: en/user_customization-packages.ssi:273
#: en/user_customization-packages.ssi:283 en/user_examples.ssi:12
-#: en/user_examples.ssi:27 en/user_examples.ssi:37 en/user_examples.ssi:75
-#: en/user_installation.ssi:38 en/user_installation.ssi:46
-#: en/user_installation.ssi:56 en/user_installation.ssi:64
-#: en/user_installation.ssi:76 en/user_installation.ssi:84
-#: en/user_installation.ssi:104 en/user_installation.ssi:118
-#: en/user_installation.ssi:135 en/user_managing_a_configuration.ssi:24
+#: en/user_examples.ssi:27 en/user_examples.ssi:37 en/user_examples.ssi:51
+#: en/user_examples.ssi:61 en/user_examples.ssi:89 en/user_examples.ssi:110
+#: en/user_examples.ssi:118 en/user_installation.ssi:38
+#: en/user_installation.ssi:46 en/user_installation.ssi:56
+#: en/user_installation.ssi:64 en/user_installation.ssi:76
+#: en/user_installation.ssi:84 en/user_installation.ssi:104
+#: en/user_installation.ssi:118 en/user_installation.ssi:135
+#: en/user_managing_a_configuration.ssi:24
#: en/user_managing_a_configuration.ssi:35
#: en/user_managing_a_configuration.ssi:47 en/user_overview.ssi:36
#: en/user_overview.ssi:80 en/user_overview.ssi:88
@@ -129,12 +131,14 @@ msgstr "code{"
#: en/user_customization-packages.ssi:265
#: en/user_customization-packages.ssi:277
#: en/user_customization-packages.ssi:287 en/user_examples.ssi:17
-#: en/user_examples.ssi:31 en/user_examples.ssi:41 en/user_examples.ssi:84
-#: en/user_installation.ssi:42 en/user_installation.ssi:50
-#: en/user_installation.ssi:60 en/user_installation.ssi:72
-#: en/user_installation.ssi:80 en/user_installation.ssi:88
-#: en/user_installation.ssi:108 en/user_installation.ssi:123
-#: en/user_installation.ssi:138 en/user_managing_a_configuration.ssi:31
+#: en/user_examples.ssi:31 en/user_examples.ssi:41 en/user_examples.ssi:55
+#: en/user_examples.ssi:65 en/user_examples.ssi:98 en/user_examples.ssi:114
+#: en/user_examples.ssi:122 en/user_installation.ssi:42
+#: en/user_installation.ssi:50 en/user_installation.ssi:60
+#: en/user_installation.ssi:72 en/user_installation.ssi:80
+#: en/user_installation.ssi:88 en/user_installation.ssi:108
+#: en/user_installation.ssi:123 en/user_installation.ssi:138
+#: en/user_managing_a_configuration.ssi:31
#: en/user_managing_a_configuration.ssi:43
#: en/user_managing_a_configuration.ssi:52 en/user_overview.ssi:74
#: en/user_overview.ssi:84 en/user_overview.ssi:92
@@ -146,13 +150,12 @@ msgstr "}code"
#: en/other_customization-bootup.ssi:56 en/other_customization-bootup.ssi:60
#: en/other_customization-bootup.ssi:64 en/other_customization-bootup.ssi:68
#: en/other_live-environment.ssi:8 en/other_resources.ssi:8
-#: en/other_success-stories.ssi:7 en/user_examples.ssi:51
-#: en/user_examples.ssi:57
+#: en/other_success-stories.ssi:7 en/user_examples.ssi:71
msgid "FIXME"
msgstr ""
#. type: Plain text
-#: en/other_faq.ssi:85 en/other_faq.ssi:247 en/user_examples.ssi:77
+#: en/other_faq.ssi:85 en/other_faq.ssi:247 en/user_examples.ssi:91
msgid "#!/bin/sh"
msgstr ""
@@ -273,92 +276,173 @@ msgstr ""
#: en/user_examples.ssi:49
msgid ""
"In this tutorial, we will create an image suitable for use as a web browser "
-"utility using a single extra repository, a single package list, a single "
-"extra package, and a single extra file, configured with your locale and "
-"keyboard preferences, thereby introducing the various ways you can customize "
-"Debian Live images."
+"utility, serving as an introduction to customizing Debian Live images."
msgstr ""
#. type: Plain text
#: en/user_examples.ssi:53
-msgid "2~tutorial-3 Tutorial 3: A personal travelling companion"
+msgid "mkdir tutorial2 ; cd tutorial2 ; lb config -p lxde --packages iceweasel"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:55
-#, no-wrap
-msgid "*{Use case}* Create a project to build a personal travelling companion image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.\n"
+#: en/user_examples.ssi:57
+msgid ""
+"Our choice of LXDE for this example reflects our desire to provide a minimal "
+"desktop environment, since the focus of the image is the single use we have "
+"in mind, the web browser. We could go even further and provide a default "
+"configuration for the web browser in #{config/chroot_local-includes/etc/"
+"iceweasel/profile/}#, or additional support packages for viewing various "
+"kinds of web content, but we leave this as an exercise for the reader."
msgstr ""
#. type: Plain text
#: en/user_examples.ssi:59
-msgid "2~ VNC Kiosk Client"
+msgid "Build the image, keeping a log as in {Tutorial 1}#tutorial-1:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:63 en/user_examples.ssi:120
+msgid "# lb build 2>&1 | tee binary.log"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:67
+msgid "2~tutorial-3 Tutorial 3: A personalized image"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:61
+#: en/user_examples.ssi:69
+#, no-wrap
+msgid "*{Use case}* Create a project to build a personalized image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:73
+msgid "2~ A VNC Kiosk Client"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:75
msgid "Create an image with live-build to boot directly to a VNC server."
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:63
+#: en/user_examples.ssi:77
msgid "_* Make a build directory: #{$ mkdir vncBuild}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:65
+#: en/user_examples.ssi:79
msgid "_* Move to the build directory: #{$ cd vncBuild}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:67
+#: en/user_examples.ssi:81
msgid ""
"Example to config the build directory to include gdm metacity "
"xtightvncviewer: #{$ lb config --packages \"gdm3 metacity xtightvncviewer\"}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:69
+#: en/user_examples.ssi:83
msgid ""
"Create a folder /etc/skel folder for a custom .xsession for the default "
"user: #{$ mkdir -p config/chroot_local-includes/etc/skel}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:71
+#: en/user_examples.ssi:85
msgid ""
"Create the .xsession for the default user: #{$ touch config/chroot_local-"
"includes/etc/skel/.xsession}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:73
+#: en/user_examples.ssi:87
msgid ""
"Edit the .xsession file to launch metacity and start xvncviewer with "
"something similar to the below:"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:80
+#: en/user_examples.ssi:94
msgid "/usr/bin/metacity & /usr/bin/vncviewer xxx.xxx.xxx.xxx:PORT"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:82
+#: en/user_examples.ssi:96
msgid "exit"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:86
+#: en/user_examples.ssi:100
msgid "_* Build the image: #{# lb build}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:88
+#: en/user_examples.ssi:102
msgid "_* Enjoy."
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:90
-msgid "2~ Next Example FIXME"
+#: en/user_examples.ssi:104
+msgid "2~ A base image for a 128M USB key"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:106
+#, no-wrap
+msgid "*{Use case}* Create a standard image with some components removed in order to fit on a 128M USB key with space left over to use as you see fit.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:108
+msgid ""
+"When optimizing an image to fit a certain media size, you need to understand "
+"the tradeoffs you are making between size and functionality. In this "
+"example, we trim only so much as to make room for additional material within "
+"a 128M media size, but without doing anything to destroy integrity of the "
+"packages contained within, such as the purging of locale data via the #"
+"{localepurge}# package, or other such \"intrusive\" optimizations. Of "
+"particular note, you should not use #{--bootstrap-flavour minimal}# unless "
+"you really know what you're doing, as omitting priority #{important}# "
+"packages will most likely produce a broken live system."
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:112
+msgid ""
+"$ lb config -k 486 -p minimal --binary-indices false --memtest none --apt-"
+"recommends false --includes none"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:116
+msgid "Now, build the image in the usual way:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:124
+msgid ""
+"On the author's system at time of writing, the above configuration produced "
+"a 78Mbyte image. This compares favourably with the 166Mbyte image produced "
+"by the default configuration in {Tutorial 1}#tutorial-1."
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:126
+msgid ""
+"The biggest space-saver here, compared to building a standard image on an #"
+"{i386}# architecture system, is to select only the #{486}# kernel flavour "
+"instead of the default #{-k \"486 686\"}#. Leaving off APT's indices with #"
+"{--binary-indices false}# also saves a fair amount of space, the tradeoff "
+"being that you need to #{apt-get update}# before using apt in the live "
+"system. Choosing the #{minimal}# package list leaves out the large #{locales}"
+"# package and associated utilities. Dropping recommended packages with #{--"
+"apt-recommends false}# saves some additional space, at the expense of "
+"omitting some packages you might otherwise expect to be there, such as #"
+"{firmware-linux-free}# which may be needed to support certain hardware. The "
+"remaining options shave off additional small amounts of space. It's up to "
+"you to decide if the functionality that is sacrificed with each optimization "
+"is worth the loss in functionality."
msgstr ""
diff --git a/manual/pot/user_examples.ssi.pot b/manual/pot/user_examples.ssi.pot
index 897acbf..58227c7 100644
--- a/manual/pot/user_examples.ssi.pot
+++ b/manual/pot/user_examples.ssi.pot
@@ -7,7 +7,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-11-27 09:40-0400\n"
+"POT-Creation-Date: 2010-11-27 12:48-0400\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <LL at li.org>\n"
@@ -66,12 +66,14 @@ msgstr ""
#: en/user_customization-packages.ssi:261
#: en/user_customization-packages.ssi:273
#: en/user_customization-packages.ssi:283 en/user_examples.ssi:12
-#: en/user_examples.ssi:27 en/user_examples.ssi:37 en/user_examples.ssi:75
-#: en/user_installation.ssi:38 en/user_installation.ssi:46
-#: en/user_installation.ssi:56 en/user_installation.ssi:64
-#: en/user_installation.ssi:76 en/user_installation.ssi:84
-#: en/user_installation.ssi:104 en/user_installation.ssi:118
-#: en/user_installation.ssi:135 en/user_managing_a_configuration.ssi:24
+#: en/user_examples.ssi:27 en/user_examples.ssi:37 en/user_examples.ssi:51
+#: en/user_examples.ssi:61 en/user_examples.ssi:89 en/user_examples.ssi:110
+#: en/user_examples.ssi:118 en/user_installation.ssi:38
+#: en/user_installation.ssi:46 en/user_installation.ssi:56
+#: en/user_installation.ssi:64 en/user_installation.ssi:76
+#: en/user_installation.ssi:84 en/user_installation.ssi:104
+#: en/user_installation.ssi:118 en/user_installation.ssi:135
+#: en/user_managing_a_configuration.ssi:24
#: en/user_managing_a_configuration.ssi:35
#: en/user_managing_a_configuration.ssi:47 en/user_overview.ssi:36
#: en/user_overview.ssi:80 en/user_overview.ssi:88
@@ -128,12 +130,14 @@ msgstr ""
#: en/user_customization-packages.ssi:265
#: en/user_customization-packages.ssi:277
#: en/user_customization-packages.ssi:287 en/user_examples.ssi:17
-#: en/user_examples.ssi:31 en/user_examples.ssi:41 en/user_examples.ssi:84
-#: en/user_installation.ssi:42 en/user_installation.ssi:50
-#: en/user_installation.ssi:60 en/user_installation.ssi:72
-#: en/user_installation.ssi:80 en/user_installation.ssi:88
-#: en/user_installation.ssi:108 en/user_installation.ssi:123
-#: en/user_installation.ssi:138 en/user_managing_a_configuration.ssi:31
+#: en/user_examples.ssi:31 en/user_examples.ssi:41 en/user_examples.ssi:55
+#: en/user_examples.ssi:65 en/user_examples.ssi:98 en/user_examples.ssi:114
+#: en/user_examples.ssi:122 en/user_installation.ssi:42
+#: en/user_installation.ssi:50 en/user_installation.ssi:60
+#: en/user_installation.ssi:72 en/user_installation.ssi:80
+#: en/user_installation.ssi:88 en/user_installation.ssi:108
+#: en/user_installation.ssi:123 en/user_installation.ssi:138
+#: en/user_managing_a_configuration.ssi:31
#: en/user_managing_a_configuration.ssi:43
#: en/user_managing_a_configuration.ssi:52 en/user_overview.ssi:74
#: en/user_overview.ssi:84 en/user_overview.ssi:92
@@ -145,13 +149,12 @@ msgstr ""
#: en/other_customization-bootup.ssi:56 en/other_customization-bootup.ssi:60
#: en/other_customization-bootup.ssi:64 en/other_customization-bootup.ssi:68
#: en/other_live-environment.ssi:8 en/other_resources.ssi:8
-#: en/other_success-stories.ssi:7 en/user_examples.ssi:51
-#: en/user_examples.ssi:57
+#: en/other_success-stories.ssi:7 en/user_examples.ssi:71
msgid "FIXME"
msgstr ""
#. type: Plain text
-#: en/other_faq.ssi:85 en/other_faq.ssi:247 en/user_examples.ssi:77
+#: en/other_faq.ssi:85 en/other_faq.ssi:247 en/user_examples.ssi:91
msgid "#!/bin/sh"
msgstr ""
@@ -272,92 +275,173 @@ msgstr ""
#: en/user_examples.ssi:49
msgid ""
"In this tutorial, we will create an image suitable for use as a web browser "
-"utility using a single extra repository, a single package list, a single "
-"extra package, and a single extra file, configured with your locale and "
-"keyboard preferences, thereby introducing the various ways you can customize "
-"Debian Live images."
+"utility, serving as an introduction to customizing Debian Live images."
msgstr ""
#. type: Plain text
#: en/user_examples.ssi:53
-msgid "2~tutorial-3 Tutorial 3: A personal travelling companion"
+msgid "mkdir tutorial2 ; cd tutorial2 ; lb config -p lxde --packages iceweasel"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:55
-#, no-wrap
-msgid "*{Use case}* Create a project to build a personal travelling companion image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.\n"
+#: en/user_examples.ssi:57
+msgid ""
+"Our choice of LXDE for this example reflects our desire to provide a minimal "
+"desktop environment, since the focus of the image is the single use we have "
+"in mind, the web browser. We could go even further and provide a default "
+"configuration for the web browser in #{config/chroot_local-includes/etc/"
+"iceweasel/profile/}#, or additional support packages for viewing various "
+"kinds of web content, but we leave this as an exercise for the reader."
msgstr ""
#. type: Plain text
#: en/user_examples.ssi:59
-msgid "2~ VNC Kiosk Client"
+msgid "Build the image, keeping a log as in {Tutorial 1}#tutorial-1:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:63 en/user_examples.ssi:120
+msgid "# lb build 2>&1 | tee binary.log"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:67
+msgid "2~tutorial-3 Tutorial 3: A personalized image"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:61
+#: en/user_examples.ssi:69
+#, no-wrap
+msgid "*{Use case}* Create a project to build a personalized image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:73
+msgid "2~ A VNC Kiosk Client"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:75
msgid "Create an image with live-build to boot directly to a VNC server."
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:63
+#: en/user_examples.ssi:77
msgid "_* Make a build directory: #{$ mkdir vncBuild}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:65
+#: en/user_examples.ssi:79
msgid "_* Move to the build directory: #{$ cd vncBuild}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:67
+#: en/user_examples.ssi:81
msgid ""
"Example to config the build directory to include gdm metacity "
"xtightvncviewer: #{$ lb config --packages \"gdm3 metacity xtightvncviewer\"}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:69
+#: en/user_examples.ssi:83
msgid ""
"Create a folder /etc/skel folder for a custom .xsession for the default "
"user: #{$ mkdir -p config/chroot_local-includes/etc/skel}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:71
+#: en/user_examples.ssi:85
msgid ""
"Create the .xsession for the default user: #{$ touch config/chroot_local-"
"includes/etc/skel/.xsession}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:73
+#: en/user_examples.ssi:87
msgid ""
"Edit the .xsession file to launch metacity and start xvncviewer with "
"something similar to the below:"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:80
+#: en/user_examples.ssi:94
msgid "/usr/bin/metacity & /usr/bin/vncviewer xxx.xxx.xxx.xxx:PORT"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:82
+#: en/user_examples.ssi:96
msgid "exit"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:86
+#: en/user_examples.ssi:100
msgid "_* Build the image: #{# lb build}#"
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:88
+#: en/user_examples.ssi:102
msgid "_* Enjoy."
msgstr ""
#. type: Plain text
-#: en/user_examples.ssi:90
-msgid "2~ Next Example FIXME"
+#: en/user_examples.ssi:104
+msgid "2~ A base image for a 128M USB key"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:106
+#, no-wrap
+msgid "*{Use case}* Create a standard image with some components removed in order to fit on a 128M USB key with space left over to use as you see fit.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:108
+msgid ""
+"When optimizing an image to fit a certain media size, you need to understand "
+"the tradeoffs you are making between size and functionality. In this "
+"example, we trim only so much as to make room for additional material within "
+"a 128M media size, but without doing anything to destroy integrity of the "
+"packages contained within, such as the purging of locale data via the #"
+"{localepurge}# package, or other such \"intrusive\" optimizations. Of "
+"particular note, you should not use #{--bootstrap-flavour minimal}# unless "
+"you really know what you're doing, as omitting priority #{important}# "
+"packages will most likely produce a broken live system."
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:112
+msgid ""
+"$ lb config -k 486 -p minimal --binary-indices false --memtest none --apt-"
+"recommends false --includes none"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:116
+msgid "Now, build the image in the usual way:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:124
+msgid ""
+"On the author's system at time of writing, the above configuration produced "
+"a 78Mbyte image. This compares favourably with the 166Mbyte image produced "
+"by the default configuration in {Tutorial 1}#tutorial-1."
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:126
+msgid ""
+"The biggest space-saver here, compared to building a standard image on an #"
+"{i386}# architecture system, is to select only the #{486}# kernel flavour "
+"instead of the default #{-k \"486 686\"}#. Leaving off APT's indices with #"
+"{--binary-indices false}# also saves a fair amount of space, the tradeoff "
+"being that you need to #{apt-get update}# before using apt in the live "
+"system. Choosing the #{minimal}# package list leaves out the large #{locales}"
+"# package and associated utilities. Dropping recommended packages with #{--"
+"apt-recommends false}# saves some additional space, at the expense of "
+"omitting some packages you might otherwise expect to be there, such as #"
+"{firmware-linux-free}# which may be needed to support certain hardware. The "
+"remaining options shave off additional small amounts of space. It's up to "
+"you to decide if the functionality that is sacrificed with each optimization "
+"is worth the loss in functionality."
msgstr ""
diff --git a/manual/pt_BR/user_examples.ssi b/manual/pt_BR/user_examples.ssi
index d265d54..1214813 100644
--- a/manual/pt_BR/user_examples.ssi
+++ b/manual/pt_BR/user_examples.ssi
@@ -64,20 +64,37 @@ stick}#copying-usb-hdd-image, respectively.
*{Use case}* Create a web browser utility image, learning how to apply customizations
In this tutorial, we will create an image suitable for use as a web browser
-utility using a single extra repository, a single package list, a single
-extra package, and a single extra file, configured with your locale and
-keyboard preferences, thereby introducing the various ways you can customize
-Debian Live images.
+utility, serving as an introduction to customizing Debian Live images.
-FIXME
+code{
-2~tutorial-3 Tutorial 3: A personal travelling companion
+mkdir tutorial2 ; cd tutorial2 ; lb config -p lxde --packages iceweasel
+
+}code
-*{Use case}* Create a project to build a personal travelling companion image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.
+Our choice of LXDE for this example reflects our desire to provide a minimal
+desktop environment, since the focus of the image is the single use we have
+in mind, the web browser. We could go even further and provide a default
+configuration for the web browser in
+#{config/chroot_local-includes/etc/iceweasel/profile/}#, or additional
+support packages for viewing various kinds of web content, but we leave this
+as an exercise for the reader.
+
+Build the image, keeping a log as in {Tutorial 1}#tutorial-1:
+
+code{
+
+# lb build 2>&1 | tee binary.log
+
+}code
+
+2~tutorial-3 Tutorial 3: A personalized image
+
+*{Use case}* Create a project to build a personalized image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.
FIXME
-2~ VNC Kiosk Client
+2~ A VNC Kiosk Client
Create an image with live-build to boot directly to a VNC server.
@@ -111,6 +128,50 @@ _* Build the image: #{# lb build}#
_* Enjoy.
-2~ Next Example FIXME
+2~ A base image for a 128M USB key
+
+*{Use case}* Create a standard image with some components removed in order to fit on a 128M USB key with space left over to use as you see fit.
+
+When optimizing an image to fit a certain media size, you need to understand
+the tradeoffs you are making between size and functionality. In this
+example, we trim only so much as to make room for additional material within
+a 128M media size, but without doing anything to destroy integrity of the
+packages contained within, such as the purging of locale data via the
+#{localepurge}# package, or other such "intrusive" optimizations. Of
+particular note, you should not use #{--bootstrap-flavour minimal}# unless
+you really know what you're doing, as omitting priority #{important}#
+packages will most likely produce a broken live system.
+
+code{
+
+$ lb config -k 486 -p minimal --binary-indices false --memtest none
+--apt-recommends false --includes none
+
+}code
+
+Now, build the image in the usual way:
+
+code{
+
+# lb build 2>&1 | tee binary.log
+
+}code
+On the author's system at time of writing, the above configuration produced
+a 78Mbyte image. This compares favourably with the 166Mbyte image produced
+by the default configuration in {Tutorial 1}#tutorial-1.
+
+The biggest space-saver here, compared to building a standard image on an
+#{i386}# architecture system, is to select only the #{486}# kernel flavour
+instead of the default #{-k "486 686"}#. Leaving off APT's indices with
+#{--binary-indices false}# also saves a fair amount of space, the tradeoff
+being that you need to #{apt-get update}# before using apt in the live
+system. Choosing the #{minimal}# package list leaves out the large
+#{locales}# package and associated utilities. Dropping recommended packages
+with #{--apt-recommends false}# saves some additional space, at the expense
+of omitting some packages you might otherwise expect to be there, such as
+#{firmware-linux-free}# which may be needed to support certain hardware. The
+remaining options shave off additional small amounts of space. It's up to
+you to decide if the functionality that is sacrificed with each optimization
+is worth the loss in functionality.
diff --git a/manual/ro/user_examples.ssi b/manual/ro/user_examples.ssi
index d265d54..1214813 100644
--- a/manual/ro/user_examples.ssi
+++ b/manual/ro/user_examples.ssi
@@ -64,20 +64,37 @@ stick}#copying-usb-hdd-image, respectively.
*{Use case}* Create a web browser utility image, learning how to apply customizations
In this tutorial, we will create an image suitable for use as a web browser
-utility using a single extra repository, a single package list, a single
-extra package, and a single extra file, configured with your locale and
-keyboard preferences, thereby introducing the various ways you can customize
-Debian Live images.
+utility, serving as an introduction to customizing Debian Live images.
-FIXME
+code{
-2~tutorial-3 Tutorial 3: A personal travelling companion
+mkdir tutorial2 ; cd tutorial2 ; lb config -p lxde --packages iceweasel
+
+}code
-*{Use case}* Create a project to build a personal travelling companion image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.
+Our choice of LXDE for this example reflects our desire to provide a minimal
+desktop environment, since the focus of the image is the single use we have
+in mind, the web browser. We could go even further and provide a default
+configuration for the web browser in
+#{config/chroot_local-includes/etc/iceweasel/profile/}#, or additional
+support packages for viewing various kinds of web content, but we leave this
+as an exercise for the reader.
+
+Build the image, keeping a log as in {Tutorial 1}#tutorial-1:
+
+code{
+
+# lb build 2>&1 | tee binary.log
+
+}code
+
+2~tutorial-3 Tutorial 3: A personalized image
+
+*{Use case}* Create a project to build a personalized image, containing your favourite software to take with you on a USB stick wherever you go, and evolving in successive revisions as your needs and preferences change.
FIXME
-2~ VNC Kiosk Client
+2~ A VNC Kiosk Client
Create an image with live-build to boot directly to a VNC server.
@@ -111,6 +128,50 @@ _* Build the image: #{# lb build}#
_* Enjoy.
-2~ Next Example FIXME
+2~ A base image for a 128M USB key
+
+*{Use case}* Create a standard image with some components removed in order to fit on a 128M USB key with space left over to use as you see fit.
+
+When optimizing an image to fit a certain media size, you need to understand
+the tradeoffs you are making between size and functionality. In this
+example, we trim only so much as to make room for additional material within
+a 128M media size, but without doing anything to destroy integrity of the
+packages contained within, such as the purging of locale data via the
+#{localepurge}# package, or other such "intrusive" optimizations. Of
+particular note, you should not use #{--bootstrap-flavour minimal}# unless
+you really know what you're doing, as omitting priority #{important}#
+packages will most likely produce a broken live system.
+
+code{
+
+$ lb config -k 486 -p minimal --binary-indices false --memtest none
+--apt-recommends false --includes none
+
+}code
+
+Now, build the image in the usual way:
+
+code{
+
+# lb build 2>&1 | tee binary.log
+
+}code
+On the author's system at time of writing, the above configuration produced
+a 78Mbyte image. This compares favourably with the 166Mbyte image produced
+by the default configuration in {Tutorial 1}#tutorial-1.
+
+The biggest space-saver here, compared to building a standard image on an
+#{i386}# architecture system, is to select only the #{486}# kernel flavour
+instead of the default #{-k "486 686"}#. Leaving off APT's indices with
+#{--binary-indices false}# also saves a fair amount of space, the tradeoff
+being that you need to #{apt-get update}# before using apt in the live
+system. Choosing the #{minimal}# package list leaves out the large
+#{locales}# package and associated utilities. Dropping recommended packages
+with #{--apt-recommends false}# saves some additional space, at the expense
+of omitting some packages you might otherwise expect to be there, such as
+#{firmware-linux-free}# which may be needed to support certain hardware. The
+remaining options shave off additional small amounts of space. It's up to
+you to decide if the functionality that is sacrificed with each optimization
+is worth the loss in functionality.
--
live-manual
More information about the debian-live-changes
mailing list