[SCM] live-manual branch, debian, updated. debian/2.0_a12-1-7-g366acb4
Ben Armstrong
synrg at debian.org
Tue Dec 7 22:13:15 UTC 2010
The following commit has been merged in the debian branch:
commit 366acb4eb84091ed4e2d87a9a0bc0e2a642a1559
Author: Ben Armstrong <synrg at debian.org>
Date: Tue Dec 7 18:13:08 2010 -0400
Adding localization example.
diff --git a/manual/de/user_examples.ssi b/manual/de/user_examples.ssi
index 0bb4753..d3f44f8 100644
--- a/manual/de/user_examples.ssi
+++ b/manual/de/user_examples.ssi
@@ -32,7 +32,7 @@ LB_MIRROR_CHROOT_SECURITY="http://mirror/debian-security"
2~tutorial-1 Tutorial 1: A standard image
-*{Use case:}* Create a simple first image, learning the basics of live-build
+*{Use case:}* Create a simple first image, learning the basics of live-build.
In this tutorial, we will build a default ISO hybrid Debian Live image
containing only base packages (no Xorg) and some Debian Live support
@@ -69,7 +69,7 @@ stick}#copying-usb-hdd-image, respectively.
2~tutorial-2 Tutorial 2: A web browser utility
-*{Use case}* Create a web browser utility image, learning how to apply customizations
+*{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, serving as an introduction to customizing Debian Live images.
@@ -101,7 +101,7 @@ Again, verify the image is OK and test, as in {Tutorial 1}#tutorial-1.
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.
+*{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.
Since we will be changing our personalized image over a number of revisions,
and we want to track those changes, trying things experimentally and
@@ -224,7 +224,7 @@ cases drawn from the collected experiences of users of Debian Live.
2~ A VNC Kiosk Client
-Create an image with live-build to boot directly to a VNC server.
+*{Use case:}* Create an image with live-build to boot directly to a VNC server.
_* Make a build directory: #{$ mkdir vncBuild}#
@@ -258,7 +258,7 @@ _* Enjoy.
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.
+*{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
@@ -303,3 +303,79 @@ 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.
+2~ A localized KDE desktop and installer
+
+*{Use case:}* Create a KDE desktop image, localized for Brazilian Portuguese and including an installer.
+
+We want to make an iso-hybrid image for i386 architecture using our
+preferred desktop, in this case KDE, containing all of the same packages
+that would be installed by the standard Debian installer for KDE.
+
+Our initial problem is the discovery of the names of the appropriate
+tasks. Currently, live-build cannot help with this. While we might get lucky
+and find this by trial-and-error, there is a tool, #{grep-dctrl}#, which can
+be used to dig it out of the task descriptions in tasksel-data, so to
+prepare, make sure you have both of those things:
+
+code{
+
+# apt-get install dctrl-tools tasksel-data
+
+}code
+
+Now we can search for the appropriate tasks, first with:
+
+code{
+
+$ grep-dctrl -FTest-lang pt_BR /usr/share/tasksel/debian-tasks.desc -sTask,Description
+Task: brazilian-portuguese
+Description: Brazilian Portuguese environment
+ This task installs programs, data files, and
+ documentation that make it easier for Brazilian Portuguese speakers
+ to use Debian.
+
+}code
+
+By this command, we discover the task is called, plainly enough,
+brazilian-portuguese. Now to find the related tasks:
+
+code{
+
+$ grep-dctrl -FEnhances brazilian-portuguese /usr/share/tasksel/debian-tasks.desc -sTask,Description
+Task: brazilian-portuguese-desktop
+Description: Brazilian Portuguese desktop
+ This task localises the desktop in Brasilian Portuguese.
+
+Task: brazilian-portuguese-kde-desktop
+Description: Brazilian Portuguese KDE desktop
+ This task localises the KDE desktop in Brazilian Portuguese.
+
+}code
+
+We will use the experimental #{--language}# option, as live-build happens to
+include #{syslinux}# templates for pt_BR (see {Desktop and language
+tasks}#destkop-and-language-tasks for details). And at boot time we will
+generate the pt_BR.UTF-8 locale and select the pt-latin1 keyboard
+layout. Now let's put the pieces together:
+
+code{
+
+$ mkdir live-pt_BR-kde
+$ cd live-pt_BR-kde
+$ lb config \
+ -a i386 \
+ -k 486 \
+ -p kde-desktop \
+ --language pt_BR \
+ --tasks "brazilian-portuguese brazilian-portuguese-desktop brazilian-portuguese-kde-desktop" \
+ --bootappend-live "locales=pt_BR.UTF-8 keyboard-layouts=pt-latin1"
+ --debian-installer live \
+ --packages debian-installer-launcher
+
+}code
+
+Note that we have included the #{debian-installer-launcher}# package to
+launch the installer from the live desktop, and have also specified the 486
+flavour kernel, as it is currently necessary to make the installer and live
+system kernels match for the launcher to work properly.
+
diff --git a/manual/en/user_examples.ssi b/manual/en/user_examples.ssi
index 11222c7..0863469 100644
--- a/manual/en/user_examples.ssi
+++ b/manual/en/user_examples.ssi
@@ -20,7 +20,7 @@ LB_MIRROR_CHROOT_SECURITY="http://mirror/debian-security"
2~tutorial-1 Tutorial 1: A standard image
-*{Use case:}* Create a simple first image, learning the basics of live-build
+*{Use case:}* Create a simple first image, learning the basics of live-build.
In this tutorial, we will build a default ISO hybrid Debian Live image containing only base packages (no Xorg) and some Debian Live support packages, as a first exercise in using live-build.
@@ -46,7 +46,7 @@ Assuming all goes well, after a while, the current directory will contain #{bina
2~tutorial-2 Tutorial 2: A web browser utility
-*{Use case}* Create a web browser utility image, learning how to apply customizations
+*{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, serving as an introduction to customizing Debian Live images.
@@ -70,7 +70,7 @@ Again, verify the image is OK and test, as in {Tutorial 1}#tutorial-1.
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.
+*{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.
Since we will be changing our personalized image over a number of revisions, and we want to track those changes, trying things experimentally and possibly reverting them if things don't work out, we will keep our configuration in the popular #{git}# version control system. We will also use the best practice of autoconfiguration via #{auto}# scripts as described in {Managing a configuration}#managing-a-configuration.
@@ -170,7 +170,7 @@ We've come to the end of our tutorial series. While many more kinds of customiza
2~ A VNC Kiosk Client
-Create an image with live-build to boot directly to a VNC server.
+*{Use case:}* Create an image with live-build to boot directly to a VNC server.
_* Make a build directory: #{$ mkdir vncBuild}#
@@ -201,7 +201,7 @@ _* Enjoy.
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.
+*{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.
@@ -223,3 +223,65 @@ On the author's system at time of writing, the above configuration produced a 78
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.
+2~ A localized KDE desktop and installer
+
+*{Use case:}* Create a KDE desktop image, localized for Brazilian Portuguese and including an installer.
+
+We want to make an iso-hybrid image for i386 architecture using our preferred desktop, in this case KDE, containing all of the same packages that would be installed by the standard Debian installer for KDE.
+
+Our initial problem is the discovery of the names of the appropriate tasks. Currently, live-build cannot help with this. While we might get lucky and find this by trial-and-error, there is a tool, #{grep-dctrl}#, which can be used to dig it out of the task descriptions in tasksel-data, so to prepare, make sure you have both of those things:
+
+code{
+
+# apt-get install dctrl-tools tasksel-data
+
+}code
+
+Now we can search for the appropriate tasks, first with:
+
+code{
+
+$ grep-dctrl -FTest-lang pt_BR /usr/share/tasksel/debian-tasks.desc -sTask,Description
+Task: brazilian-portuguese
+Description: Brazilian Portuguese environment
+ This task installs programs, data files, and
+ documentation that make it easier for Brazilian Portuguese speakers
+ to use Debian.
+
+}code
+
+By this command, we discover the task is called, plainly enough, brazilian-portuguese. Now to find the related tasks:
+
+code{
+
+$ grep-dctrl -FEnhances brazilian-portuguese /usr/share/tasksel/debian-tasks.desc -sTask,Description
+Task: brazilian-portuguese-desktop
+Description: Brazilian Portuguese desktop
+ This task localises the desktop in Brasilian Portuguese.
+
+Task: brazilian-portuguese-kde-desktop
+Description: Brazilian Portuguese KDE desktop
+ This task localises the KDE desktop in Brazilian Portuguese.
+
+}code
+
+We will use the experimental #{--language}# option, as live-build happens to include #{syslinux}# templates for pt_BR (see {Desktop and language tasks}#destkop-and-language-tasks for details). And at boot time we will generate the pt_BR.UTF-8 locale and select the pt-latin1 keyboard layout. Now let's put the pieces together:
+
+code{
+
+$ mkdir live-pt_BR-kde
+$ cd live-pt_BR-kde
+$ lb config \
+ -a i386 \
+ -k 486 \
+ -p kde-desktop \
+ --language pt_BR \
+ --tasks "brazilian-portuguese brazilian-portuguese-desktop brazilian-portuguese-kde-desktop" \
+ --bootappend-live "locales=pt_BR.UTF-8 keyboard-layouts=pt-latin1"
+ --debian-installer live \
+ --packages debian-installer-launcher
+
+}code
+
+Note that we have included the #{debian-installer-launcher}# package to launch the installer from the live desktop, and have also specified the 486 flavour kernel, as it is currently necessary to make the installer and live system kernels match for the launcher to work properly.
+
diff --git a/manual/fr/user_examples.ssi b/manual/fr/user_examples.ssi
index 0bb4753..d3f44f8 100644
--- a/manual/fr/user_examples.ssi
+++ b/manual/fr/user_examples.ssi
@@ -32,7 +32,7 @@ LB_MIRROR_CHROOT_SECURITY="http://mirror/debian-security"
2~tutorial-1 Tutorial 1: A standard image
-*{Use case:}* Create a simple first image, learning the basics of live-build
+*{Use case:}* Create a simple first image, learning the basics of live-build.
In this tutorial, we will build a default ISO hybrid Debian Live image
containing only base packages (no Xorg) and some Debian Live support
@@ -69,7 +69,7 @@ stick}#copying-usb-hdd-image, respectively.
2~tutorial-2 Tutorial 2: A web browser utility
-*{Use case}* Create a web browser utility image, learning how to apply customizations
+*{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, serving as an introduction to customizing Debian Live images.
@@ -101,7 +101,7 @@ Again, verify the image is OK and test, as in {Tutorial 1}#tutorial-1.
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.
+*{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.
Since we will be changing our personalized image over a number of revisions,
and we want to track those changes, trying things experimentally and
@@ -224,7 +224,7 @@ cases drawn from the collected experiences of users of Debian Live.
2~ A VNC Kiosk Client
-Create an image with live-build to boot directly to a VNC server.
+*{Use case:}* Create an image with live-build to boot directly to a VNC server.
_* Make a build directory: #{$ mkdir vncBuild}#
@@ -258,7 +258,7 @@ _* Enjoy.
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.
+*{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
@@ -303,3 +303,79 @@ 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.
+2~ A localized KDE desktop and installer
+
+*{Use case:}* Create a KDE desktop image, localized for Brazilian Portuguese and including an installer.
+
+We want to make an iso-hybrid image for i386 architecture using our
+preferred desktop, in this case KDE, containing all of the same packages
+that would be installed by the standard Debian installer for KDE.
+
+Our initial problem is the discovery of the names of the appropriate
+tasks. Currently, live-build cannot help with this. While we might get lucky
+and find this by trial-and-error, there is a tool, #{grep-dctrl}#, which can
+be used to dig it out of the task descriptions in tasksel-data, so to
+prepare, make sure you have both of those things:
+
+code{
+
+# apt-get install dctrl-tools tasksel-data
+
+}code
+
+Now we can search for the appropriate tasks, first with:
+
+code{
+
+$ grep-dctrl -FTest-lang pt_BR /usr/share/tasksel/debian-tasks.desc -sTask,Description
+Task: brazilian-portuguese
+Description: Brazilian Portuguese environment
+ This task installs programs, data files, and
+ documentation that make it easier for Brazilian Portuguese speakers
+ to use Debian.
+
+}code
+
+By this command, we discover the task is called, plainly enough,
+brazilian-portuguese. Now to find the related tasks:
+
+code{
+
+$ grep-dctrl -FEnhances brazilian-portuguese /usr/share/tasksel/debian-tasks.desc -sTask,Description
+Task: brazilian-portuguese-desktop
+Description: Brazilian Portuguese desktop
+ This task localises the desktop in Brasilian Portuguese.
+
+Task: brazilian-portuguese-kde-desktop
+Description: Brazilian Portuguese KDE desktop
+ This task localises the KDE desktop in Brazilian Portuguese.
+
+}code
+
+We will use the experimental #{--language}# option, as live-build happens to
+include #{syslinux}# templates for pt_BR (see {Desktop and language
+tasks}#destkop-and-language-tasks for details). And at boot time we will
+generate the pt_BR.UTF-8 locale and select the pt-latin1 keyboard
+layout. Now let's put the pieces together:
+
+code{
+
+$ mkdir live-pt_BR-kde
+$ cd live-pt_BR-kde
+$ lb config \
+ -a i386 \
+ -k 486 \
+ -p kde-desktop \
+ --language pt_BR \
+ --tasks "brazilian-portuguese brazilian-portuguese-desktop brazilian-portuguese-kde-desktop" \
+ --bootappend-live "locales=pt_BR.UTF-8 keyboard-layouts=pt-latin1"
+ --debian-installer live \
+ --packages debian-installer-launcher
+
+}code
+
+Note that we have included the #{debian-installer-launcher}# package to
+launch the installer from the live desktop, and have also specified the 486
+flavour kernel, as it is currently necessary to make the installer and live
+system kernels match for the launcher to work properly.
+
diff --git a/manual/it/user_examples.ssi b/manual/it/user_examples.ssi
index 0bb4753..d3f44f8 100644
--- a/manual/it/user_examples.ssi
+++ b/manual/it/user_examples.ssi
@@ -32,7 +32,7 @@ LB_MIRROR_CHROOT_SECURITY="http://mirror/debian-security"
2~tutorial-1 Tutorial 1: A standard image
-*{Use case:}* Create a simple first image, learning the basics of live-build
+*{Use case:}* Create a simple first image, learning the basics of live-build.
In this tutorial, we will build a default ISO hybrid Debian Live image
containing only base packages (no Xorg) and some Debian Live support
@@ -69,7 +69,7 @@ stick}#copying-usb-hdd-image, respectively.
2~tutorial-2 Tutorial 2: A web browser utility
-*{Use case}* Create a web browser utility image, learning how to apply customizations
+*{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, serving as an introduction to customizing Debian Live images.
@@ -101,7 +101,7 @@ Again, verify the image is OK and test, as in {Tutorial 1}#tutorial-1.
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.
+*{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.
Since we will be changing our personalized image over a number of revisions,
and we want to track those changes, trying things experimentally and
@@ -224,7 +224,7 @@ cases drawn from the collected experiences of users of Debian Live.
2~ A VNC Kiosk Client
-Create an image with live-build to boot directly to a VNC server.
+*{Use case:}* Create an image with live-build to boot directly to a VNC server.
_* Make a build directory: #{$ mkdir vncBuild}#
@@ -258,7 +258,7 @@ _* Enjoy.
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.
+*{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
@@ -303,3 +303,79 @@ 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.
+2~ A localized KDE desktop and installer
+
+*{Use case:}* Create a KDE desktop image, localized for Brazilian Portuguese and including an installer.
+
+We want to make an iso-hybrid image for i386 architecture using our
+preferred desktop, in this case KDE, containing all of the same packages
+that would be installed by the standard Debian installer for KDE.
+
+Our initial problem is the discovery of the names of the appropriate
+tasks. Currently, live-build cannot help with this. While we might get lucky
+and find this by trial-and-error, there is a tool, #{grep-dctrl}#, which can
+be used to dig it out of the task descriptions in tasksel-data, so to
+prepare, make sure you have both of those things:
+
+code{
+
+# apt-get install dctrl-tools tasksel-data
+
+}code
+
+Now we can search for the appropriate tasks, first with:
+
+code{
+
+$ grep-dctrl -FTest-lang pt_BR /usr/share/tasksel/debian-tasks.desc -sTask,Description
+Task: brazilian-portuguese
+Description: Brazilian Portuguese environment
+ This task installs programs, data files, and
+ documentation that make it easier for Brazilian Portuguese speakers
+ to use Debian.
+
+}code
+
+By this command, we discover the task is called, plainly enough,
+brazilian-portuguese. Now to find the related tasks:
+
+code{
+
+$ grep-dctrl -FEnhances brazilian-portuguese /usr/share/tasksel/debian-tasks.desc -sTask,Description
+Task: brazilian-portuguese-desktop
+Description: Brazilian Portuguese desktop
+ This task localises the desktop in Brasilian Portuguese.
+
+Task: brazilian-portuguese-kde-desktop
+Description: Brazilian Portuguese KDE desktop
+ This task localises the KDE desktop in Brazilian Portuguese.
+
+}code
+
+We will use the experimental #{--language}# option, as live-build happens to
+include #{syslinux}# templates for pt_BR (see {Desktop and language
+tasks}#destkop-and-language-tasks for details). And at boot time we will
+generate the pt_BR.UTF-8 locale and select the pt-latin1 keyboard
+layout. Now let's put the pieces together:
+
+code{
+
+$ mkdir live-pt_BR-kde
+$ cd live-pt_BR-kde
+$ lb config \
+ -a i386 \
+ -k 486 \
+ -p kde-desktop \
+ --language pt_BR \
+ --tasks "brazilian-portuguese brazilian-portuguese-desktop brazilian-portuguese-kde-desktop" \
+ --bootappend-live "locales=pt_BR.UTF-8 keyboard-layouts=pt-latin1"
+ --debian-installer live \
+ --packages debian-installer-launcher
+
+}code
+
+Note that we have included the #{debian-installer-launcher}# package to
+launch the installer from the live desktop, and have also specified the 486
+flavour kernel, as it is currently necessary to make the installer and live
+system kernels match for the launcher to work properly.
+
diff --git a/manual/po/de/user_examples.ssi.po b/manual/po/de/user_examples.ssi.po
index 42e37c0..e7ad468 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 2.0~a12\n"
-"POT-Creation-Date: 2010-11-28 07:51-0400\n"
+"POT-Creation-Date: 2010-12-07 18:11-0400\n"
"PO-Revision-Date: 2010-11-04 16:34-0400\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -20,27 +20,19 @@ msgstr ""
#: en/about_manual.ssi:84 en/about_manual.ssi:92 en/about_manual.ssi:100
#: en/about_manual.ssi:108 en/about_manual.ssi:120 en/about_manual.ssi:133
#: en/about_manual.ssi:146 en/about_manual.ssi:154 en/about_manual.ssi:162
-#: en/about_manual.ssi:170 en/other_coding-style.ssi:28
-#: en/other_coding-style.ssi:38 en/other_coding-style.ssi:51
-#: en/other_coding-style.ssi:61 en/other_coding-style.ssi:88
-#: en/other_coding-style.ssi:96 en/other_coding-style.ssi:106
-#: en/other_coding-style.ssi:117 en/other_common-tasks.ssi:32
-#: en/other_customization-backports.ssi:8 en/other_customization-bootup.ssi:30
-#: en/other_customization-bootup.ssi:39 en/other_faq.ssi:41
-#: en/other_faq.ssi:83 en/other_faq.ssi:103 en/other_faq.ssi:117
-#: en/other_faq.ssi:137 en/other_faq.ssi:151 en/other_faq.ssi:198
-#: en/other_faq.ssi:245 en/other_faq.ssi:261 en/other_faq.ssi:287
-#: en/other_faq.ssi:299 en/other_faq.ssi:314 en/other_faq.ssi:333
-#: en/other_faq.ssi:345 en/other_faq.ssi:353 en/other_faq.ssi:364
-#: en/other_faq.ssi:374 en/other_howtos.ssi:16 en/other_howtos.ssi:43
-#: en/other_live-environment.ssi:14 en/other_live-environment.ssi:30
-#: en/other_live-environment.ssi:51 en/other_live-environment.ssi:61
-#: en/other_live-environment.ssi:69 en/other_live-environment.ssi:77
-#: en/other_live-environment.ssi:85 en/other_live-environment.ssi:93
-#: en/other_live-environment.ssi:116 en/other_live-environment.ssi:124
-#: en/other_live-environment.ssi:133 en/other_procedures.ssi:12
-#: en/other_procedures.ssi:46 en/other_procedures.ssi:58
-#: en/project_bugs.ssi:58 en/user_basics.ssi:32 en/user_basics.ssi:42
+#: en/about_manual.ssi:170 en/other_faq.ssi:41 en/other_faq.ssi:83
+#: en/other_faq.ssi:103 en/other_faq.ssi:117 en/other_faq.ssi:137
+#: en/other_faq.ssi:151 en/other_faq.ssi:198 en/other_faq.ssi:245
+#: en/other_faq.ssi:261 en/other_faq.ssi:287 en/other_faq.ssi:299
+#: en/other_faq.ssi:314 en/other_faq.ssi:333 en/other_faq.ssi:345
+#: en/other_faq.ssi:353 en/other_faq.ssi:364 en/other_faq.ssi:374
+#: en/other_howtos.ssi:16 en/other_howtos.ssi:43 en/project_bugs.ssi:58
+#: en/project_coding-style.ssi:28 en/project_coding-style.ssi:38
+#: en/project_coding-style.ssi:51 en/project_coding-style.ssi:61
+#: en/project_coding-style.ssi:92 en/project_coding-style.ssi:100
+#: en/project_coding-style.ssi:110 en/project_coding-style.ssi:121
+#: en/project_procedures.ssi:12 en/project_procedures.ssi:46
+#: en/project_procedures.ssi:58 en/user_basics.ssi:32 en/user_basics.ssi:42
#: en/user_basics.ssi:54 en/user_basics.ssi:66 en/user_basics.ssi:78
#: en/user_basics.ssi:88 en/user_basics.ssi:102 en/user_basics.ssi:110
#: en/user_basics.ssi:118 en/user_basics.ssi:128 en/user_basics.ssi:142
@@ -49,36 +41,43 @@ msgstr ""
#: en/user_basics.ssi:222 en/user_basics.ssi:255 en/user_basics.ssi:271
#: en/user_basics.ssi:279 en/user_basics.ssi:299 en/user_basics.ssi:324
#: en/user_customization-contents.ssi:34 en/user_customization-contents.ssi:43
-#: en/user_customization-contents.ssi:66
-#: en/user_customization-internationalization.ssi:10
-#: en/user_customization-internationalization.ssi:18
-#: en/user_customization-internationalization.ssi:26
-#: en/user_customization-internationalization.ssi:38
-#: en/user_customization-packages.ssi:18 en/user_customization-packages.ssi:31
-#: en/user_customization-packages.ssi:44 en/user_customization-packages.ssi:58
-#: en/user_customization-packages.ssi:72 en/user_customization-packages.ssi:90
-#: en/user_customization-packages.ssi:120
-#: en/user_customization-packages.ssi:133
-#: en/user_customization-packages.ssi:143
-#: en/user_customization-packages.ssi:153
-#: en/user_customization-packages.ssi:163
-#: en/user_customization-packages.ssi:177
-#: en/user_customization-packages.ssi:193
-#: en/user_customization-packages.ssi:261
-#: en/user_customization-packages.ssi:273
-#: en/user_customization-packages.ssi:283 en/user_examples.ssi:14
-#: en/user_examples.ssi:30 en/user_examples.ssi:40 en/user_examples.ssi:54
-#: en/user_examples.ssi:64 en/user_examples.ssi:80 en/user_examples.ssi:90
-#: en/user_examples.ssi:107 en/user_examples.ssi:117 en/user_examples.ssi:131
-#: en/user_examples.ssi:139 en/user_examples.ssi:154 en/user_examples.ssi:162
-#: en/user_examples.ssi:188 en/user_examples.ssi:209 en/user_examples.ssi:217
+#: en/user_customization-contents.ssi:66 en/user_customization-packages.ssi:14
+#: en/user_customization-packages.ssi:22 en/user_customization-packages.ssi:40
+#: en/user_customization-packages.ssi:53 en/user_customization-packages.ssi:66
+#: en/user_customization-packages.ssi:80 en/user_customization-packages.ssi:94
+#: en/user_customization-packages.ssi:112
+#: en/user_customization-packages.ssi:142
+#: en/user_customization-packages.ssi:155
+#: en/user_customization-packages.ssi:165
+#: en/user_customization-packages.ssi:175
+#: en/user_customization-packages.ssi:185
+#: en/user_customization-packages.ssi:199
+#: en/user_customization-packages.ssi:215
+#: en/user_customization-packages.ssi:227
+#: en/user_customization-packages.ssi:290
+#: en/user_customization-packages.ssi:302
+#: en/user_customization-packages.ssi:312
+#: en/user_customization-packages.ssi:330 en/user_customization-runtime.ssi:14
+#: en/user_customization-runtime.ssi:32 en/user_customization-runtime.ssi:42
+#: en/user_customization-runtime.ssi:50 en/user_customization-runtime.ssi:58
+#: en/user_customization-runtime.ssi:66 en/user_customization-runtime.ssi:86
+#: en/user_customization-runtime.ssi:94 en/user_customization-runtime.ssi:103
+#: en/user_examples.ssi:14 en/user_examples.ssi:30 en/user_examples.ssi:40
+#: en/user_examples.ssi:54 en/user_examples.ssi:64 en/user_examples.ssi:80
+#: en/user_examples.ssi:90 en/user_examples.ssi:107 en/user_examples.ssi:117
+#: en/user_examples.ssi:131 en/user_examples.ssi:139 en/user_examples.ssi:154
+#: en/user_examples.ssi:162 en/user_examples.ssi:188 en/user_examples.ssi:209
+#: en/user_examples.ssi:217 en/user_examples.ssi:235 en/user_examples.ssi:243
+#: en/user_examples.ssi:256 en/user_examples.ssi:271
#: 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_installation.ssi:74 en/user_installation.ssi:82
+#: en/user_installation.ssi:90 en/user_installation.ssi:114
+#: en/user_installation.ssi:132 en/user_installation.ssi:147
+#: 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_managing_a_configuration.ssi:47
+#: en/user_managing_a_configuration.ssi:56 en/user_overview.ssi:36
#: en/user_overview.ssi:80 en/user_overview.ssi:88
msgid "code{"
msgstr ""
@@ -87,27 +86,19 @@ msgstr ""
#: en/about_manual.ssi:88 en/about_manual.ssi:96 en/about_manual.ssi:104
#: en/about_manual.ssi:112 en/about_manual.ssi:129 en/about_manual.ssi:142
#: en/about_manual.ssi:150 en/about_manual.ssi:158 en/about_manual.ssi:166
-#: en/about_manual.ssi:173 en/other_coding-style.ssi:34
-#: en/other_coding-style.ssi:45 en/other_coding-style.ssi:57
-#: en/other_coding-style.ssi:68 en/other_coding-style.ssi:92
-#: en/other_coding-style.ssi:100 en/other_coding-style.ssi:113
-#: en/other_coding-style.ssi:124 en/other_common-tasks.ssi:36
-#: en/other_customization-backports.ssi:16
-#: en/other_customization-bootup.ssi:35 en/other_customization-bootup.ssi:48
-#: en/other_faq.ssi:37 en/other_faq.ssi:46 en/other_faq.ssi:92
-#: en/other_faq.ssi:108 en/other_faq.ssi:141 en/other_faq.ssi:155
-#: en/other_faq.ssi:207 en/other_faq.ssi:256 en/other_faq.ssi:292
-#: en/other_faq.ssi:307 en/other_faq.ssi:319 en/other_faq.ssi:337
-#: en/other_faq.ssi:349 en/other_faq.ssi:358 en/other_faq.ssi:370
-#: en/other_faq.ssi:381 en/other_howtos.ssi:20 en/other_howtos.ssi:47
-#: en/other_live-environment.ssi:18 en/other_live-environment.ssi:34
-#: en/other_live-environment.ssi:55 en/other_live-environment.ssi:65
-#: en/other_live-environment.ssi:73 en/other_live-environment.ssi:81
-#: en/other_live-environment.ssi:89 en/other_live-environment.ssi:97
-#: en/other_live-environment.ssi:120 en/other_live-environment.ssi:129
-#: en/other_live-environment.ssi:138 en/other_procedures.ssi:16
-#: en/other_procedures.ssi:54 en/other_procedures.ssi:131
-#: en/project_bugs.ssi:62 en/user_basics.ssi:36 en/user_basics.ssi:46
+#: en/about_manual.ssi:174 en/other_faq.ssi:37 en/other_faq.ssi:46
+#: en/other_faq.ssi:92 en/other_faq.ssi:108 en/other_faq.ssi:141
+#: en/other_faq.ssi:155 en/other_faq.ssi:207 en/other_faq.ssi:256
+#: en/other_faq.ssi:292 en/other_faq.ssi:307 en/other_faq.ssi:319
+#: en/other_faq.ssi:337 en/other_faq.ssi:349 en/other_faq.ssi:358
+#: en/other_faq.ssi:370 en/other_faq.ssi:381 en/other_howtos.ssi:20
+#: en/other_howtos.ssi:47 en/project_bugs.ssi:62
+#: en/project_coding-style.ssi:34 en/project_coding-style.ssi:45
+#: en/project_coding-style.ssi:57 en/project_coding-style.ssi:68
+#: en/project_coding-style.ssi:96 en/project_coding-style.ssi:104
+#: en/project_coding-style.ssi:117 en/project_coding-style.ssi:128
+#: en/project_procedures.ssi:16 en/project_procedures.ssi:54
+#: en/project_procedures.ssi:131 en/user_basics.ssi:36 en/user_basics.ssi:46
#: en/user_basics.ssi:60 en/user_basics.ssi:72 en/user_basics.ssi:82
#: en/user_basics.ssi:94 en/user_basics.ssi:106 en/user_basics.ssi:114
#: en/user_basics.ssi:122 en/user_basics.ssi:132 en/user_basics.ssi:148
@@ -116,36 +107,42 @@ msgstr ""
#: en/user_basics.ssi:247 en/user_basics.ssi:259 en/user_basics.ssi:275
#: en/user_basics.ssi:283 en/user_basics.ssi:310 en/user_basics.ssi:349
#: en/user_customization-contents.ssi:39 en/user_customization-contents.ssi:54
-#: en/user_customization-contents.ssi:70
-#: en/user_customization-internationalization.ssi:14
-#: en/user_customization-internationalization.ssi:22
-#: en/user_customization-internationalization.ssi:30
-#: en/user_customization-internationalization.ssi:42
-#: en/user_customization-packages.ssi:23 en/user_customization-packages.ssi:36
-#: en/user_customization-packages.ssi:48 en/user_customization-packages.ssi:62
-#: en/user_customization-packages.ssi:76 en/user_customization-packages.ssi:94
-#: en/user_customization-packages.ssi:125
-#: en/user_customization-packages.ssi:139
-#: en/user_customization-packages.ssi:149
-#: en/user_customization-packages.ssi:159
-#: en/user_customization-packages.ssi:169
+#: en/user_customization-contents.ssi:70 en/user_customization-packages.ssi:18
+#: en/user_customization-packages.ssi:26 en/user_customization-packages.ssi:45
+#: en/user_customization-packages.ssi:58 en/user_customization-packages.ssi:70
+#: en/user_customization-packages.ssi:84 en/user_customization-packages.ssi:98
+#: en/user_customization-packages.ssi:116
+#: en/user_customization-packages.ssi:147
+#: en/user_customization-packages.ssi:161
+#: en/user_customization-packages.ssi:171
#: en/user_customization-packages.ssi:181
-#: en/user_customization-packages.ssi:197
-#: en/user_customization-packages.ssi:265
-#: en/user_customization-packages.ssi:277
-#: en/user_customization-packages.ssi:287 en/user_examples.ssi:20
-#: en/user_examples.ssi:34 en/user_examples.ssi:44 en/user_examples.ssi:58
-#: en/user_examples.ssi:68 en/user_examples.ssi:86 en/user_examples.ssi:101
-#: en/user_examples.ssi:111 en/user_examples.ssi:123 en/user_examples.ssi:135
-#: en/user_examples.ssi:150 en/user_examples.ssi:158 en/user_examples.ssi:166
-#: en/user_examples.ssi:197 en/user_examples.ssi:213 en/user_examples.ssi:221
+#: en/user_customization-packages.ssi:191
+#: en/user_customization-packages.ssi:203
+#: en/user_customization-packages.ssi:219
+#: en/user_customization-packages.ssi:294
+#: en/user_customization-packages.ssi:306
+#: en/user_customization-packages.ssi:316
+#: en/user_customization-packages.ssi:343 en/user_customization-runtime.ssi:18
+#: en/user_customization-runtime.ssi:36 en/user_customization-runtime.ssi:46
+#: en/user_customization-runtime.ssi:54 en/user_customization-runtime.ssi:62
+#: en/user_customization-runtime.ssi:70 en/user_customization-runtime.ssi:90
+#: en/user_customization-runtime.ssi:99 en/user_customization-runtime.ssi:108
+#: en/user_examples.ssi:20 en/user_examples.ssi:34 en/user_examples.ssi:44
+#: en/user_examples.ssi:58 en/user_examples.ssi:68 en/user_examples.ssi:86
+#: en/user_examples.ssi:101 en/user_examples.ssi:111 en/user_examples.ssi:123
+#: en/user_examples.ssi:135 en/user_examples.ssi:150 en/user_examples.ssi:158
+#: en/user_examples.ssi:166 en/user_examples.ssi:197 en/user_examples.ssi:213
+#: en/user_examples.ssi:221 en/user_examples.ssi:239 en/user_examples.ssi:252
+#: en/user_examples.ssi:267 en/user_examples.ssi:285
#: 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_installation.ssi:60 en/user_installation.ssi:70
+#: en/user_installation.ssi:78 en/user_installation.ssi:86
+#: en/user_installation.ssi:94 en/user_installation.ssi:118
+#: en/user_installation.ssi:137 en/user_installation.ssi:150
+#: 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_managing_a_configuration.ssi:52
+#: en/user_managing_a_configuration.ssi:60 en/user_overview.ssi:74
#: en/user_overview.ssi:84 en/user_overview.ssi:92
msgid "}code"
msgstr ""
@@ -222,7 +219,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:24
#, no-wrap
-msgid "*{Use case:}* Create a simple first image, learning the basics of live-build\n"
+msgid "*{Use case:}* Create a simple first image, learning the basics of live-build.\n"
msgstr ""
#. type: Plain text
@@ -283,7 +280,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:50
#, no-wrap
-msgid "*{Use case}* Create a web browser utility image, learning how to apply customizations\n"
+msgid "*{Use case:}* Create a web browser utility image, learning how to apply customizations.\n"
msgstr ""
#. type: Plain text
@@ -334,7 +331,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:74
#, 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"
+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
@@ -499,7 +496,8 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:174
-msgid "Create an image with live-build to boot directly to a VNC server."
+#, no-wrap
+msgid "*{Use case:}* Create an image with live-build to boot directly to a VNC server.\n"
msgstr ""
#. type: Plain text
@@ -568,7 +566,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:205
#, 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"
+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
@@ -622,3 +620,116 @@ msgid ""
"you to decide if the functionality that is sacrificed with each optimization "
"is worth the loss in functionality."
msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:227
+msgid "2~ A localized KDE desktop and installer"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:229
+#, no-wrap
+msgid "*{Use case:}* Create a KDE desktop image, localized for Brazilian Portuguese and including an installer.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:231
+msgid ""
+"We want to make an iso-hybrid image for i386 architecture using our "
+"preferred desktop, in this case KDE, containing all of the same packages "
+"that would be installed by the standard Debian installer for KDE."
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:233
+msgid ""
+"Our initial problem is the discovery of the names of the appropriate tasks. "
+"Currently, live-build cannot help with this. While we might get lucky and "
+"find this by trial-and-error, there is a tool, #{grep-dctrl}#, which can be "
+"used to dig it out of the task descriptions in tasksel-data, so to prepare, "
+"make sure you have both of those things:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:237
+msgid "# apt-get install dctrl-tools tasksel-data"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:241
+msgid "Now we can search for the appropriate tasks, first with:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:250
+#, no-wrap
+msgid ""
+"$ grep-dctrl -FTest-lang pt_BR /usr/share/tasksel/debian-tasks.desc -sTask,Description\n"
+"Task: brazilian-portuguese\n"
+"Description: Brazilian Portuguese environment\n"
+" This task installs programs, data files, and\n"
+" documentation that make it easier for Brazilian Portuguese speakers\n"
+" to use Debian.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:254
+msgid ""
+"By this command, we discover the task is called, plainly enough, brazilian-"
+"portuguese. Now to find the related tasks:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:261
+#, no-wrap
+msgid ""
+"$ grep-dctrl -FEnhances brazilian-portuguese /usr/share/tasksel/debian-tasks.desc -sTask,Description\n"
+"Task: brazilian-portuguese-desktop\n"
+"Description: Brazilian Portuguese desktop\n"
+" This task localises the desktop in Brasilian Portuguese.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:265
+#, no-wrap
+msgid ""
+"Task: brazilian-portuguese-kde-desktop\n"
+"Description: Brazilian Portuguese KDE desktop\n"
+" This task localises the KDE desktop in Brazilian Portuguese.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:269
+msgid ""
+"We will use the experimental #{--language}# option, as live-build happens to "
+"include #{syslinux}# templates for pt_BR (see {Desktop and language tasks}"
+"#destkop-and-language-tasks for details). And at boot time we will generate "
+"the pt_BR.UTF-8 locale and select the pt-latin1 keyboard layout. Now let's "
+"put the pieces together:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:283
+#, no-wrap
+msgid ""
+"$ mkdir live-pt_BR-kde\n"
+"$ cd live-pt_BR-kde\n"
+"$ lb config \\\n"
+" -a i386 \\\n"
+" -k 486 \\\n"
+" -p kde-desktop \\\n"
+" --language pt_BR \\\n"
+" --tasks \"brazilian-portuguese brazilian-portuguese-desktop brazilian-portuguese-kde-desktop\" \\\n"
+" --bootappend-live \"locales=pt_BR.UTF-8 keyboard-layouts=pt-latin1\"\n"
+" --debian-installer live \\\n"
+" --packages debian-installer-launcher\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:287
+msgid ""
+"Note that we have included the #{debian-installer-launcher}# package to "
+"launch the installer from the live desktop, and have also specified the 486 "
+"flavour kernel, as it is currently necessary to make the installer and live "
+"system kernels match for the launcher to work properly."
+msgstr ""
diff --git a/manual/po/fr/user_examples.ssi.po b/manual/po/fr/user_examples.ssi.po
index 9f0bb61..7f961fe 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 2.0~a12\n"
-"POT-Creation-Date: 2010-11-28 07:51-0400\n"
+"POT-Creation-Date: 2010-12-07 18:11-0400\n"
"PO-Revision-Date: 2010-11-04 16:34-0400\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -20,27 +20,19 @@ msgstr ""
#: en/about_manual.ssi:84 en/about_manual.ssi:92 en/about_manual.ssi:100
#: en/about_manual.ssi:108 en/about_manual.ssi:120 en/about_manual.ssi:133
#: en/about_manual.ssi:146 en/about_manual.ssi:154 en/about_manual.ssi:162
-#: en/about_manual.ssi:170 en/other_coding-style.ssi:28
-#: en/other_coding-style.ssi:38 en/other_coding-style.ssi:51
-#: en/other_coding-style.ssi:61 en/other_coding-style.ssi:88
-#: en/other_coding-style.ssi:96 en/other_coding-style.ssi:106
-#: en/other_coding-style.ssi:117 en/other_common-tasks.ssi:32
-#: en/other_customization-backports.ssi:8 en/other_customization-bootup.ssi:30
-#: en/other_customization-bootup.ssi:39 en/other_faq.ssi:41
-#: en/other_faq.ssi:83 en/other_faq.ssi:103 en/other_faq.ssi:117
-#: en/other_faq.ssi:137 en/other_faq.ssi:151 en/other_faq.ssi:198
-#: en/other_faq.ssi:245 en/other_faq.ssi:261 en/other_faq.ssi:287
-#: en/other_faq.ssi:299 en/other_faq.ssi:314 en/other_faq.ssi:333
-#: en/other_faq.ssi:345 en/other_faq.ssi:353 en/other_faq.ssi:364
-#: en/other_faq.ssi:374 en/other_howtos.ssi:16 en/other_howtos.ssi:43
-#: en/other_live-environment.ssi:14 en/other_live-environment.ssi:30
-#: en/other_live-environment.ssi:51 en/other_live-environment.ssi:61
-#: en/other_live-environment.ssi:69 en/other_live-environment.ssi:77
-#: en/other_live-environment.ssi:85 en/other_live-environment.ssi:93
-#: en/other_live-environment.ssi:116 en/other_live-environment.ssi:124
-#: en/other_live-environment.ssi:133 en/other_procedures.ssi:12
-#: en/other_procedures.ssi:46 en/other_procedures.ssi:58
-#: en/project_bugs.ssi:58 en/user_basics.ssi:32 en/user_basics.ssi:42
+#: en/about_manual.ssi:170 en/other_faq.ssi:41 en/other_faq.ssi:83
+#: en/other_faq.ssi:103 en/other_faq.ssi:117 en/other_faq.ssi:137
+#: en/other_faq.ssi:151 en/other_faq.ssi:198 en/other_faq.ssi:245
+#: en/other_faq.ssi:261 en/other_faq.ssi:287 en/other_faq.ssi:299
+#: en/other_faq.ssi:314 en/other_faq.ssi:333 en/other_faq.ssi:345
+#: en/other_faq.ssi:353 en/other_faq.ssi:364 en/other_faq.ssi:374
+#: en/other_howtos.ssi:16 en/other_howtos.ssi:43 en/project_bugs.ssi:58
+#: en/project_coding-style.ssi:28 en/project_coding-style.ssi:38
+#: en/project_coding-style.ssi:51 en/project_coding-style.ssi:61
+#: en/project_coding-style.ssi:92 en/project_coding-style.ssi:100
+#: en/project_coding-style.ssi:110 en/project_coding-style.ssi:121
+#: en/project_procedures.ssi:12 en/project_procedures.ssi:46
+#: en/project_procedures.ssi:58 en/user_basics.ssi:32 en/user_basics.ssi:42
#: en/user_basics.ssi:54 en/user_basics.ssi:66 en/user_basics.ssi:78
#: en/user_basics.ssi:88 en/user_basics.ssi:102 en/user_basics.ssi:110
#: en/user_basics.ssi:118 en/user_basics.ssi:128 en/user_basics.ssi:142
@@ -49,36 +41,43 @@ msgstr ""
#: en/user_basics.ssi:222 en/user_basics.ssi:255 en/user_basics.ssi:271
#: en/user_basics.ssi:279 en/user_basics.ssi:299 en/user_basics.ssi:324
#: en/user_customization-contents.ssi:34 en/user_customization-contents.ssi:43
-#: en/user_customization-contents.ssi:66
-#: en/user_customization-internationalization.ssi:10
-#: en/user_customization-internationalization.ssi:18
-#: en/user_customization-internationalization.ssi:26
-#: en/user_customization-internationalization.ssi:38
-#: en/user_customization-packages.ssi:18 en/user_customization-packages.ssi:31
-#: en/user_customization-packages.ssi:44 en/user_customization-packages.ssi:58
-#: en/user_customization-packages.ssi:72 en/user_customization-packages.ssi:90
-#: en/user_customization-packages.ssi:120
-#: en/user_customization-packages.ssi:133
-#: en/user_customization-packages.ssi:143
-#: en/user_customization-packages.ssi:153
-#: en/user_customization-packages.ssi:163
-#: en/user_customization-packages.ssi:177
-#: en/user_customization-packages.ssi:193
-#: en/user_customization-packages.ssi:261
-#: en/user_customization-packages.ssi:273
-#: en/user_customization-packages.ssi:283 en/user_examples.ssi:14
-#: en/user_examples.ssi:30 en/user_examples.ssi:40 en/user_examples.ssi:54
-#: en/user_examples.ssi:64 en/user_examples.ssi:80 en/user_examples.ssi:90
-#: en/user_examples.ssi:107 en/user_examples.ssi:117 en/user_examples.ssi:131
-#: en/user_examples.ssi:139 en/user_examples.ssi:154 en/user_examples.ssi:162
-#: en/user_examples.ssi:188 en/user_examples.ssi:209 en/user_examples.ssi:217
+#: en/user_customization-contents.ssi:66 en/user_customization-packages.ssi:14
+#: en/user_customization-packages.ssi:22 en/user_customization-packages.ssi:40
+#: en/user_customization-packages.ssi:53 en/user_customization-packages.ssi:66
+#: en/user_customization-packages.ssi:80 en/user_customization-packages.ssi:94
+#: en/user_customization-packages.ssi:112
+#: en/user_customization-packages.ssi:142
+#: en/user_customization-packages.ssi:155
+#: en/user_customization-packages.ssi:165
+#: en/user_customization-packages.ssi:175
+#: en/user_customization-packages.ssi:185
+#: en/user_customization-packages.ssi:199
+#: en/user_customization-packages.ssi:215
+#: en/user_customization-packages.ssi:227
+#: en/user_customization-packages.ssi:290
+#: en/user_customization-packages.ssi:302
+#: en/user_customization-packages.ssi:312
+#: en/user_customization-packages.ssi:330 en/user_customization-runtime.ssi:14
+#: en/user_customization-runtime.ssi:32 en/user_customization-runtime.ssi:42
+#: en/user_customization-runtime.ssi:50 en/user_customization-runtime.ssi:58
+#: en/user_customization-runtime.ssi:66 en/user_customization-runtime.ssi:86
+#: en/user_customization-runtime.ssi:94 en/user_customization-runtime.ssi:103
+#: en/user_examples.ssi:14 en/user_examples.ssi:30 en/user_examples.ssi:40
+#: en/user_examples.ssi:54 en/user_examples.ssi:64 en/user_examples.ssi:80
+#: en/user_examples.ssi:90 en/user_examples.ssi:107 en/user_examples.ssi:117
+#: en/user_examples.ssi:131 en/user_examples.ssi:139 en/user_examples.ssi:154
+#: en/user_examples.ssi:162 en/user_examples.ssi:188 en/user_examples.ssi:209
+#: en/user_examples.ssi:217 en/user_examples.ssi:235 en/user_examples.ssi:243
+#: en/user_examples.ssi:256 en/user_examples.ssi:271
#: 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_installation.ssi:74 en/user_installation.ssi:82
+#: en/user_installation.ssi:90 en/user_installation.ssi:114
+#: en/user_installation.ssi:132 en/user_installation.ssi:147
+#: 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_managing_a_configuration.ssi:47
+#: en/user_managing_a_configuration.ssi:56 en/user_overview.ssi:36
#: en/user_overview.ssi:80 en/user_overview.ssi:88
msgid "code{"
msgstr "code{"
@@ -87,27 +86,19 @@ msgstr "code{"
#: en/about_manual.ssi:88 en/about_manual.ssi:96 en/about_manual.ssi:104
#: en/about_manual.ssi:112 en/about_manual.ssi:129 en/about_manual.ssi:142
#: en/about_manual.ssi:150 en/about_manual.ssi:158 en/about_manual.ssi:166
-#: en/about_manual.ssi:173 en/other_coding-style.ssi:34
-#: en/other_coding-style.ssi:45 en/other_coding-style.ssi:57
-#: en/other_coding-style.ssi:68 en/other_coding-style.ssi:92
-#: en/other_coding-style.ssi:100 en/other_coding-style.ssi:113
-#: en/other_coding-style.ssi:124 en/other_common-tasks.ssi:36
-#: en/other_customization-backports.ssi:16
-#: en/other_customization-bootup.ssi:35 en/other_customization-bootup.ssi:48
-#: en/other_faq.ssi:37 en/other_faq.ssi:46 en/other_faq.ssi:92
-#: en/other_faq.ssi:108 en/other_faq.ssi:141 en/other_faq.ssi:155
-#: en/other_faq.ssi:207 en/other_faq.ssi:256 en/other_faq.ssi:292
-#: en/other_faq.ssi:307 en/other_faq.ssi:319 en/other_faq.ssi:337
-#: en/other_faq.ssi:349 en/other_faq.ssi:358 en/other_faq.ssi:370
-#: en/other_faq.ssi:381 en/other_howtos.ssi:20 en/other_howtos.ssi:47
-#: en/other_live-environment.ssi:18 en/other_live-environment.ssi:34
-#: en/other_live-environment.ssi:55 en/other_live-environment.ssi:65
-#: en/other_live-environment.ssi:73 en/other_live-environment.ssi:81
-#: en/other_live-environment.ssi:89 en/other_live-environment.ssi:97
-#: en/other_live-environment.ssi:120 en/other_live-environment.ssi:129
-#: en/other_live-environment.ssi:138 en/other_procedures.ssi:16
-#: en/other_procedures.ssi:54 en/other_procedures.ssi:131
-#: en/project_bugs.ssi:62 en/user_basics.ssi:36 en/user_basics.ssi:46
+#: en/about_manual.ssi:174 en/other_faq.ssi:37 en/other_faq.ssi:46
+#: en/other_faq.ssi:92 en/other_faq.ssi:108 en/other_faq.ssi:141
+#: en/other_faq.ssi:155 en/other_faq.ssi:207 en/other_faq.ssi:256
+#: en/other_faq.ssi:292 en/other_faq.ssi:307 en/other_faq.ssi:319
+#: en/other_faq.ssi:337 en/other_faq.ssi:349 en/other_faq.ssi:358
+#: en/other_faq.ssi:370 en/other_faq.ssi:381 en/other_howtos.ssi:20
+#: en/other_howtos.ssi:47 en/project_bugs.ssi:62
+#: en/project_coding-style.ssi:34 en/project_coding-style.ssi:45
+#: en/project_coding-style.ssi:57 en/project_coding-style.ssi:68
+#: en/project_coding-style.ssi:96 en/project_coding-style.ssi:104
+#: en/project_coding-style.ssi:117 en/project_coding-style.ssi:128
+#: en/project_procedures.ssi:16 en/project_procedures.ssi:54
+#: en/project_procedures.ssi:131 en/user_basics.ssi:36 en/user_basics.ssi:46
#: en/user_basics.ssi:60 en/user_basics.ssi:72 en/user_basics.ssi:82
#: en/user_basics.ssi:94 en/user_basics.ssi:106 en/user_basics.ssi:114
#: en/user_basics.ssi:122 en/user_basics.ssi:132 en/user_basics.ssi:148
@@ -116,36 +107,42 @@ msgstr "code{"
#: en/user_basics.ssi:247 en/user_basics.ssi:259 en/user_basics.ssi:275
#: en/user_basics.ssi:283 en/user_basics.ssi:310 en/user_basics.ssi:349
#: en/user_customization-contents.ssi:39 en/user_customization-contents.ssi:54
-#: en/user_customization-contents.ssi:70
-#: en/user_customization-internationalization.ssi:14
-#: en/user_customization-internationalization.ssi:22
-#: en/user_customization-internationalization.ssi:30
-#: en/user_customization-internationalization.ssi:42
-#: en/user_customization-packages.ssi:23 en/user_customization-packages.ssi:36
-#: en/user_customization-packages.ssi:48 en/user_customization-packages.ssi:62
-#: en/user_customization-packages.ssi:76 en/user_customization-packages.ssi:94
-#: en/user_customization-packages.ssi:125
-#: en/user_customization-packages.ssi:139
-#: en/user_customization-packages.ssi:149
-#: en/user_customization-packages.ssi:159
-#: en/user_customization-packages.ssi:169
+#: en/user_customization-contents.ssi:70 en/user_customization-packages.ssi:18
+#: en/user_customization-packages.ssi:26 en/user_customization-packages.ssi:45
+#: en/user_customization-packages.ssi:58 en/user_customization-packages.ssi:70
+#: en/user_customization-packages.ssi:84 en/user_customization-packages.ssi:98
+#: en/user_customization-packages.ssi:116
+#: en/user_customization-packages.ssi:147
+#: en/user_customization-packages.ssi:161
+#: en/user_customization-packages.ssi:171
#: en/user_customization-packages.ssi:181
-#: en/user_customization-packages.ssi:197
-#: en/user_customization-packages.ssi:265
-#: en/user_customization-packages.ssi:277
-#: en/user_customization-packages.ssi:287 en/user_examples.ssi:20
-#: en/user_examples.ssi:34 en/user_examples.ssi:44 en/user_examples.ssi:58
-#: en/user_examples.ssi:68 en/user_examples.ssi:86 en/user_examples.ssi:101
-#: en/user_examples.ssi:111 en/user_examples.ssi:123 en/user_examples.ssi:135
-#: en/user_examples.ssi:150 en/user_examples.ssi:158 en/user_examples.ssi:166
-#: en/user_examples.ssi:197 en/user_examples.ssi:213 en/user_examples.ssi:221
+#: en/user_customization-packages.ssi:191
+#: en/user_customization-packages.ssi:203
+#: en/user_customization-packages.ssi:219
+#: en/user_customization-packages.ssi:294
+#: en/user_customization-packages.ssi:306
+#: en/user_customization-packages.ssi:316
+#: en/user_customization-packages.ssi:343 en/user_customization-runtime.ssi:18
+#: en/user_customization-runtime.ssi:36 en/user_customization-runtime.ssi:46
+#: en/user_customization-runtime.ssi:54 en/user_customization-runtime.ssi:62
+#: en/user_customization-runtime.ssi:70 en/user_customization-runtime.ssi:90
+#: en/user_customization-runtime.ssi:99 en/user_customization-runtime.ssi:108
+#: en/user_examples.ssi:20 en/user_examples.ssi:34 en/user_examples.ssi:44
+#: en/user_examples.ssi:58 en/user_examples.ssi:68 en/user_examples.ssi:86
+#: en/user_examples.ssi:101 en/user_examples.ssi:111 en/user_examples.ssi:123
+#: en/user_examples.ssi:135 en/user_examples.ssi:150 en/user_examples.ssi:158
+#: en/user_examples.ssi:166 en/user_examples.ssi:197 en/user_examples.ssi:213
+#: en/user_examples.ssi:221 en/user_examples.ssi:239 en/user_examples.ssi:252
+#: en/user_examples.ssi:267 en/user_examples.ssi:285
#: 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_installation.ssi:60 en/user_installation.ssi:70
+#: en/user_installation.ssi:78 en/user_installation.ssi:86
+#: en/user_installation.ssi:94 en/user_installation.ssi:118
+#: en/user_installation.ssi:137 en/user_installation.ssi:150
+#: 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_managing_a_configuration.ssi:52
+#: en/user_managing_a_configuration.ssi:60 en/user_overview.ssi:74
#: en/user_overview.ssi:84 en/user_overview.ssi:92
msgid "}code"
msgstr "}code"
@@ -222,7 +219,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:24
#, no-wrap
-msgid "*{Use case:}* Create a simple first image, learning the basics of live-build\n"
+msgid "*{Use case:}* Create a simple first image, learning the basics of live-build.\n"
msgstr ""
#. type: Plain text
@@ -283,7 +280,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:50
#, no-wrap
-msgid "*{Use case}* Create a web browser utility image, learning how to apply customizations\n"
+msgid "*{Use case:}* Create a web browser utility image, learning how to apply customizations.\n"
msgstr ""
#. type: Plain text
@@ -334,7 +331,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:74
#, 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"
+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
@@ -499,7 +496,8 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:174
-msgid "Create an image with live-build to boot directly to a VNC server."
+#, no-wrap
+msgid "*{Use case:}* Create an image with live-build to boot directly to a VNC server.\n"
msgstr ""
#. type: Plain text
@@ -568,7 +566,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:205
#, 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"
+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
@@ -622,3 +620,116 @@ msgid ""
"you to decide if the functionality that is sacrificed with each optimization "
"is worth the loss in functionality."
msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:227
+msgid "2~ A localized KDE desktop and installer"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:229
+#, no-wrap
+msgid "*{Use case:}* Create a KDE desktop image, localized for Brazilian Portuguese and including an installer.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:231
+msgid ""
+"We want to make an iso-hybrid image for i386 architecture using our "
+"preferred desktop, in this case KDE, containing all of the same packages "
+"that would be installed by the standard Debian installer for KDE."
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:233
+msgid ""
+"Our initial problem is the discovery of the names of the appropriate tasks. "
+"Currently, live-build cannot help with this. While we might get lucky and "
+"find this by trial-and-error, there is a tool, #{grep-dctrl}#, which can be "
+"used to dig it out of the task descriptions in tasksel-data, so to prepare, "
+"make sure you have both of those things:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:237
+msgid "# apt-get install dctrl-tools tasksel-data"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:241
+msgid "Now we can search for the appropriate tasks, first with:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:250
+#, no-wrap
+msgid ""
+"$ grep-dctrl -FTest-lang pt_BR /usr/share/tasksel/debian-tasks.desc -sTask,Description\n"
+"Task: brazilian-portuguese\n"
+"Description: Brazilian Portuguese environment\n"
+" This task installs programs, data files, and\n"
+" documentation that make it easier for Brazilian Portuguese speakers\n"
+" to use Debian.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:254
+msgid ""
+"By this command, we discover the task is called, plainly enough, brazilian-"
+"portuguese. Now to find the related tasks:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:261
+#, no-wrap
+msgid ""
+"$ grep-dctrl -FEnhances brazilian-portuguese /usr/share/tasksel/debian-tasks.desc -sTask,Description\n"
+"Task: brazilian-portuguese-desktop\n"
+"Description: Brazilian Portuguese desktop\n"
+" This task localises the desktop in Brasilian Portuguese.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:265
+#, no-wrap
+msgid ""
+"Task: brazilian-portuguese-kde-desktop\n"
+"Description: Brazilian Portuguese KDE desktop\n"
+" This task localises the KDE desktop in Brazilian Portuguese.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:269
+msgid ""
+"We will use the experimental #{--language}# option, as live-build happens to "
+"include #{syslinux}# templates for pt_BR (see {Desktop and language tasks}"
+"#destkop-and-language-tasks for details). And at boot time we will generate "
+"the pt_BR.UTF-8 locale and select the pt-latin1 keyboard layout. Now let's "
+"put the pieces together:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:283
+#, no-wrap
+msgid ""
+"$ mkdir live-pt_BR-kde\n"
+"$ cd live-pt_BR-kde\n"
+"$ lb config \\\n"
+" -a i386 \\\n"
+" -k 486 \\\n"
+" -p kde-desktop \\\n"
+" --language pt_BR \\\n"
+" --tasks \"brazilian-portuguese brazilian-portuguese-desktop brazilian-portuguese-kde-desktop\" \\\n"
+" --bootappend-live \"locales=pt_BR.UTF-8 keyboard-layouts=pt-latin1\"\n"
+" --debian-installer live \\\n"
+" --packages debian-installer-launcher\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:287
+msgid ""
+"Note that we have included the #{debian-installer-launcher}# package to "
+"launch the installer from the live desktop, and have also specified the 486 "
+"flavour kernel, as it is currently necessary to make the installer and live "
+"system kernels match for the launcher to work properly."
+msgstr ""
diff --git a/manual/po/it/user_examples.ssi.po b/manual/po/it/user_examples.ssi.po
index 532d103..20c9d06 100644
--- a/manual/po/it/user_examples.ssi.po
+++ b/manual/po/it/user_examples.ssi.po
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-11-28 07:51-0400\n"
+"POT-Creation-Date: 2010-12-07 18:11-0400\n"
"PO-Revision-Date: 2010-11-28 07:51-0400\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -20,27 +20,19 @@ msgstr ""
#: en/about_manual.ssi:84 en/about_manual.ssi:92 en/about_manual.ssi:100
#: en/about_manual.ssi:108 en/about_manual.ssi:120 en/about_manual.ssi:133
#: en/about_manual.ssi:146 en/about_manual.ssi:154 en/about_manual.ssi:162
-#: en/about_manual.ssi:170 en/other_coding-style.ssi:28
-#: en/other_coding-style.ssi:38 en/other_coding-style.ssi:51
-#: en/other_coding-style.ssi:61 en/other_coding-style.ssi:88
-#: en/other_coding-style.ssi:96 en/other_coding-style.ssi:106
-#: en/other_coding-style.ssi:117 en/other_common-tasks.ssi:32
-#: en/other_customization-backports.ssi:8 en/other_customization-bootup.ssi:30
-#: en/other_customization-bootup.ssi:39 en/other_faq.ssi:41
-#: en/other_faq.ssi:83 en/other_faq.ssi:103 en/other_faq.ssi:117
-#: en/other_faq.ssi:137 en/other_faq.ssi:151 en/other_faq.ssi:198
-#: en/other_faq.ssi:245 en/other_faq.ssi:261 en/other_faq.ssi:287
-#: en/other_faq.ssi:299 en/other_faq.ssi:314 en/other_faq.ssi:333
-#: en/other_faq.ssi:345 en/other_faq.ssi:353 en/other_faq.ssi:364
-#: en/other_faq.ssi:374 en/other_howtos.ssi:16 en/other_howtos.ssi:43
-#: en/other_live-environment.ssi:14 en/other_live-environment.ssi:30
-#: en/other_live-environment.ssi:51 en/other_live-environment.ssi:61
-#: en/other_live-environment.ssi:69 en/other_live-environment.ssi:77
-#: en/other_live-environment.ssi:85 en/other_live-environment.ssi:93
-#: en/other_live-environment.ssi:116 en/other_live-environment.ssi:124
-#: en/other_live-environment.ssi:133 en/other_procedures.ssi:12
-#: en/other_procedures.ssi:46 en/other_procedures.ssi:58
-#: en/project_bugs.ssi:58 en/user_basics.ssi:32 en/user_basics.ssi:42
+#: en/about_manual.ssi:170 en/other_faq.ssi:41 en/other_faq.ssi:83
+#: en/other_faq.ssi:103 en/other_faq.ssi:117 en/other_faq.ssi:137
+#: en/other_faq.ssi:151 en/other_faq.ssi:198 en/other_faq.ssi:245
+#: en/other_faq.ssi:261 en/other_faq.ssi:287 en/other_faq.ssi:299
+#: en/other_faq.ssi:314 en/other_faq.ssi:333 en/other_faq.ssi:345
+#: en/other_faq.ssi:353 en/other_faq.ssi:364 en/other_faq.ssi:374
+#: en/other_howtos.ssi:16 en/other_howtos.ssi:43 en/project_bugs.ssi:58
+#: en/project_coding-style.ssi:28 en/project_coding-style.ssi:38
+#: en/project_coding-style.ssi:51 en/project_coding-style.ssi:61
+#: en/project_coding-style.ssi:92 en/project_coding-style.ssi:100
+#: en/project_coding-style.ssi:110 en/project_coding-style.ssi:121
+#: en/project_procedures.ssi:12 en/project_procedures.ssi:46
+#: en/project_procedures.ssi:58 en/user_basics.ssi:32 en/user_basics.ssi:42
#: en/user_basics.ssi:54 en/user_basics.ssi:66 en/user_basics.ssi:78
#: en/user_basics.ssi:88 en/user_basics.ssi:102 en/user_basics.ssi:110
#: en/user_basics.ssi:118 en/user_basics.ssi:128 en/user_basics.ssi:142
@@ -49,36 +41,43 @@ msgstr ""
#: en/user_basics.ssi:222 en/user_basics.ssi:255 en/user_basics.ssi:271
#: en/user_basics.ssi:279 en/user_basics.ssi:299 en/user_basics.ssi:324
#: en/user_customization-contents.ssi:34 en/user_customization-contents.ssi:43
-#: en/user_customization-contents.ssi:66
-#: en/user_customization-internationalization.ssi:10
-#: en/user_customization-internationalization.ssi:18
-#: en/user_customization-internationalization.ssi:26
-#: en/user_customization-internationalization.ssi:38
-#: en/user_customization-packages.ssi:18 en/user_customization-packages.ssi:31
-#: en/user_customization-packages.ssi:44 en/user_customization-packages.ssi:58
-#: en/user_customization-packages.ssi:72 en/user_customization-packages.ssi:90
-#: en/user_customization-packages.ssi:120
-#: en/user_customization-packages.ssi:133
-#: en/user_customization-packages.ssi:143
-#: en/user_customization-packages.ssi:153
-#: en/user_customization-packages.ssi:163
-#: en/user_customization-packages.ssi:177
-#: en/user_customization-packages.ssi:193
-#: en/user_customization-packages.ssi:261
-#: en/user_customization-packages.ssi:273
-#: en/user_customization-packages.ssi:283 en/user_examples.ssi:14
-#: en/user_examples.ssi:30 en/user_examples.ssi:40 en/user_examples.ssi:54
-#: en/user_examples.ssi:64 en/user_examples.ssi:80 en/user_examples.ssi:90
-#: en/user_examples.ssi:107 en/user_examples.ssi:117 en/user_examples.ssi:131
-#: en/user_examples.ssi:139 en/user_examples.ssi:154 en/user_examples.ssi:162
-#: en/user_examples.ssi:188 en/user_examples.ssi:209 en/user_examples.ssi:217
+#: en/user_customization-contents.ssi:66 en/user_customization-packages.ssi:14
+#: en/user_customization-packages.ssi:22 en/user_customization-packages.ssi:40
+#: en/user_customization-packages.ssi:53 en/user_customization-packages.ssi:66
+#: en/user_customization-packages.ssi:80 en/user_customization-packages.ssi:94
+#: en/user_customization-packages.ssi:112
+#: en/user_customization-packages.ssi:142
+#: en/user_customization-packages.ssi:155
+#: en/user_customization-packages.ssi:165
+#: en/user_customization-packages.ssi:175
+#: en/user_customization-packages.ssi:185
+#: en/user_customization-packages.ssi:199
+#: en/user_customization-packages.ssi:215
+#: en/user_customization-packages.ssi:227
+#: en/user_customization-packages.ssi:290
+#: en/user_customization-packages.ssi:302
+#: en/user_customization-packages.ssi:312
+#: en/user_customization-packages.ssi:330 en/user_customization-runtime.ssi:14
+#: en/user_customization-runtime.ssi:32 en/user_customization-runtime.ssi:42
+#: en/user_customization-runtime.ssi:50 en/user_customization-runtime.ssi:58
+#: en/user_customization-runtime.ssi:66 en/user_customization-runtime.ssi:86
+#: en/user_customization-runtime.ssi:94 en/user_customization-runtime.ssi:103
+#: en/user_examples.ssi:14 en/user_examples.ssi:30 en/user_examples.ssi:40
+#: en/user_examples.ssi:54 en/user_examples.ssi:64 en/user_examples.ssi:80
+#: en/user_examples.ssi:90 en/user_examples.ssi:107 en/user_examples.ssi:117
+#: en/user_examples.ssi:131 en/user_examples.ssi:139 en/user_examples.ssi:154
+#: en/user_examples.ssi:162 en/user_examples.ssi:188 en/user_examples.ssi:209
+#: en/user_examples.ssi:217 en/user_examples.ssi:235 en/user_examples.ssi:243
+#: en/user_examples.ssi:256 en/user_examples.ssi:271
#: 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_installation.ssi:74 en/user_installation.ssi:82
+#: en/user_installation.ssi:90 en/user_installation.ssi:114
+#: en/user_installation.ssi:132 en/user_installation.ssi:147
+#: 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_managing_a_configuration.ssi:47
+#: en/user_managing_a_configuration.ssi:56 en/user_overview.ssi:36
#: en/user_overview.ssi:80 en/user_overview.ssi:88
msgid "code{"
msgstr "code{"
@@ -87,27 +86,19 @@ msgstr "code{"
#: en/about_manual.ssi:88 en/about_manual.ssi:96 en/about_manual.ssi:104
#: en/about_manual.ssi:112 en/about_manual.ssi:129 en/about_manual.ssi:142
#: en/about_manual.ssi:150 en/about_manual.ssi:158 en/about_manual.ssi:166
-#: en/about_manual.ssi:173 en/other_coding-style.ssi:34
-#: en/other_coding-style.ssi:45 en/other_coding-style.ssi:57
-#: en/other_coding-style.ssi:68 en/other_coding-style.ssi:92
-#: en/other_coding-style.ssi:100 en/other_coding-style.ssi:113
-#: en/other_coding-style.ssi:124 en/other_common-tasks.ssi:36
-#: en/other_customization-backports.ssi:16
-#: en/other_customization-bootup.ssi:35 en/other_customization-bootup.ssi:48
-#: en/other_faq.ssi:37 en/other_faq.ssi:46 en/other_faq.ssi:92
-#: en/other_faq.ssi:108 en/other_faq.ssi:141 en/other_faq.ssi:155
-#: en/other_faq.ssi:207 en/other_faq.ssi:256 en/other_faq.ssi:292
-#: en/other_faq.ssi:307 en/other_faq.ssi:319 en/other_faq.ssi:337
-#: en/other_faq.ssi:349 en/other_faq.ssi:358 en/other_faq.ssi:370
-#: en/other_faq.ssi:381 en/other_howtos.ssi:20 en/other_howtos.ssi:47
-#: en/other_live-environment.ssi:18 en/other_live-environment.ssi:34
-#: en/other_live-environment.ssi:55 en/other_live-environment.ssi:65
-#: en/other_live-environment.ssi:73 en/other_live-environment.ssi:81
-#: en/other_live-environment.ssi:89 en/other_live-environment.ssi:97
-#: en/other_live-environment.ssi:120 en/other_live-environment.ssi:129
-#: en/other_live-environment.ssi:138 en/other_procedures.ssi:16
-#: en/other_procedures.ssi:54 en/other_procedures.ssi:131
-#: en/project_bugs.ssi:62 en/user_basics.ssi:36 en/user_basics.ssi:46
+#: en/about_manual.ssi:174 en/other_faq.ssi:37 en/other_faq.ssi:46
+#: en/other_faq.ssi:92 en/other_faq.ssi:108 en/other_faq.ssi:141
+#: en/other_faq.ssi:155 en/other_faq.ssi:207 en/other_faq.ssi:256
+#: en/other_faq.ssi:292 en/other_faq.ssi:307 en/other_faq.ssi:319
+#: en/other_faq.ssi:337 en/other_faq.ssi:349 en/other_faq.ssi:358
+#: en/other_faq.ssi:370 en/other_faq.ssi:381 en/other_howtos.ssi:20
+#: en/other_howtos.ssi:47 en/project_bugs.ssi:62
+#: en/project_coding-style.ssi:34 en/project_coding-style.ssi:45
+#: en/project_coding-style.ssi:57 en/project_coding-style.ssi:68
+#: en/project_coding-style.ssi:96 en/project_coding-style.ssi:104
+#: en/project_coding-style.ssi:117 en/project_coding-style.ssi:128
+#: en/project_procedures.ssi:16 en/project_procedures.ssi:54
+#: en/project_procedures.ssi:131 en/user_basics.ssi:36 en/user_basics.ssi:46
#: en/user_basics.ssi:60 en/user_basics.ssi:72 en/user_basics.ssi:82
#: en/user_basics.ssi:94 en/user_basics.ssi:106 en/user_basics.ssi:114
#: en/user_basics.ssi:122 en/user_basics.ssi:132 en/user_basics.ssi:148
@@ -116,36 +107,42 @@ msgstr "code{"
#: en/user_basics.ssi:247 en/user_basics.ssi:259 en/user_basics.ssi:275
#: en/user_basics.ssi:283 en/user_basics.ssi:310 en/user_basics.ssi:349
#: en/user_customization-contents.ssi:39 en/user_customization-contents.ssi:54
-#: en/user_customization-contents.ssi:70
-#: en/user_customization-internationalization.ssi:14
-#: en/user_customization-internationalization.ssi:22
-#: en/user_customization-internationalization.ssi:30
-#: en/user_customization-internationalization.ssi:42
-#: en/user_customization-packages.ssi:23 en/user_customization-packages.ssi:36
-#: en/user_customization-packages.ssi:48 en/user_customization-packages.ssi:62
-#: en/user_customization-packages.ssi:76 en/user_customization-packages.ssi:94
-#: en/user_customization-packages.ssi:125
-#: en/user_customization-packages.ssi:139
-#: en/user_customization-packages.ssi:149
-#: en/user_customization-packages.ssi:159
-#: en/user_customization-packages.ssi:169
+#: en/user_customization-contents.ssi:70 en/user_customization-packages.ssi:18
+#: en/user_customization-packages.ssi:26 en/user_customization-packages.ssi:45
+#: en/user_customization-packages.ssi:58 en/user_customization-packages.ssi:70
+#: en/user_customization-packages.ssi:84 en/user_customization-packages.ssi:98
+#: en/user_customization-packages.ssi:116
+#: en/user_customization-packages.ssi:147
+#: en/user_customization-packages.ssi:161
+#: en/user_customization-packages.ssi:171
#: en/user_customization-packages.ssi:181
-#: en/user_customization-packages.ssi:197
-#: en/user_customization-packages.ssi:265
-#: en/user_customization-packages.ssi:277
-#: en/user_customization-packages.ssi:287 en/user_examples.ssi:20
-#: en/user_examples.ssi:34 en/user_examples.ssi:44 en/user_examples.ssi:58
-#: en/user_examples.ssi:68 en/user_examples.ssi:86 en/user_examples.ssi:101
-#: en/user_examples.ssi:111 en/user_examples.ssi:123 en/user_examples.ssi:135
-#: en/user_examples.ssi:150 en/user_examples.ssi:158 en/user_examples.ssi:166
-#: en/user_examples.ssi:197 en/user_examples.ssi:213 en/user_examples.ssi:221
+#: en/user_customization-packages.ssi:191
+#: en/user_customization-packages.ssi:203
+#: en/user_customization-packages.ssi:219
+#: en/user_customization-packages.ssi:294
+#: en/user_customization-packages.ssi:306
+#: en/user_customization-packages.ssi:316
+#: en/user_customization-packages.ssi:343 en/user_customization-runtime.ssi:18
+#: en/user_customization-runtime.ssi:36 en/user_customization-runtime.ssi:46
+#: en/user_customization-runtime.ssi:54 en/user_customization-runtime.ssi:62
+#: en/user_customization-runtime.ssi:70 en/user_customization-runtime.ssi:90
+#: en/user_customization-runtime.ssi:99 en/user_customization-runtime.ssi:108
+#: en/user_examples.ssi:20 en/user_examples.ssi:34 en/user_examples.ssi:44
+#: en/user_examples.ssi:58 en/user_examples.ssi:68 en/user_examples.ssi:86
+#: en/user_examples.ssi:101 en/user_examples.ssi:111 en/user_examples.ssi:123
+#: en/user_examples.ssi:135 en/user_examples.ssi:150 en/user_examples.ssi:158
+#: en/user_examples.ssi:166 en/user_examples.ssi:197 en/user_examples.ssi:213
+#: en/user_examples.ssi:221 en/user_examples.ssi:239 en/user_examples.ssi:252
+#: en/user_examples.ssi:267 en/user_examples.ssi:285
#: 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_installation.ssi:60 en/user_installation.ssi:70
+#: en/user_installation.ssi:78 en/user_installation.ssi:86
+#: en/user_installation.ssi:94 en/user_installation.ssi:118
+#: en/user_installation.ssi:137 en/user_installation.ssi:150
+#: 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_managing_a_configuration.ssi:52
+#: en/user_managing_a_configuration.ssi:60 en/user_overview.ssi:74
#: en/user_overview.ssi:84 en/user_overview.ssi:92
msgid "}code"
msgstr "}code"
@@ -223,7 +220,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:24
#, no-wrap
-msgid "*{Use case:}* Create a simple first image, learning the basics of live-build\n"
+msgid "*{Use case:}* Create a simple first image, learning the basics of live-build.\n"
msgstr ""
#. type: Plain text
@@ -284,7 +281,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:50
#, no-wrap
-msgid "*{Use case}* Create a web browser utility image, learning how to apply customizations\n"
+msgid "*{Use case:}* Create a web browser utility image, learning how to apply customizations.\n"
msgstr ""
#. type: Plain text
@@ -335,7 +332,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:74
#, 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"
+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
@@ -500,7 +497,8 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:174
-msgid "Create an image with live-build to boot directly to a VNC server."
+#, no-wrap
+msgid "*{Use case:}* Create an image with live-build to boot directly to a VNC server.\n"
msgstr ""
#. type: Plain text
@@ -569,7 +567,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:205
#, 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"
+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
@@ -623,3 +621,118 @@ msgid ""
"you to decide if the functionality that is sacrificed with each optimization "
"is worth the loss in functionality."
msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:227
+msgid "2~ A localized KDE desktop and installer"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:229
+#, no-wrap
+msgid "*{Use case:}* Create a KDE desktop image, localized for Brazilian Portuguese and including an installer.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:231
+msgid ""
+"We want to make an iso-hybrid image for i386 architecture using our "
+"preferred desktop, in this case KDE, containing all of the same packages "
+"that would be installed by the standard Debian installer for KDE."
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:233
+msgid ""
+"Our initial problem is the discovery of the names of the appropriate tasks. "
+"Currently, live-build cannot help with this. While we might get lucky and "
+"find this by trial-and-error, there is a tool, #{grep-dctrl}#, which can be "
+"used to dig it out of the task descriptions in tasksel-data, so to prepare, "
+"make sure you have both of those things:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:237
+#, fuzzy
+#| msgid "# apt-get install make po4a sisu-complete"
+msgid "# apt-get install dctrl-tools tasksel-data"
+msgstr "# apt-get install make po4a sisu-complete"
+
+#. type: Plain text
+#: en/user_examples.ssi:241
+msgid "Now we can search for the appropriate tasks, first with:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:250
+#, no-wrap
+msgid ""
+"$ grep-dctrl -FTest-lang pt_BR /usr/share/tasksel/debian-tasks.desc -sTask,Description\n"
+"Task: brazilian-portuguese\n"
+"Description: Brazilian Portuguese environment\n"
+" This task installs programs, data files, and\n"
+" documentation that make it easier for Brazilian Portuguese speakers\n"
+" to use Debian.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:254
+msgid ""
+"By this command, we discover the task is called, plainly enough, brazilian-"
+"portuguese. Now to find the related tasks:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:261
+#, no-wrap
+msgid ""
+"$ grep-dctrl -FEnhances brazilian-portuguese /usr/share/tasksel/debian-tasks.desc -sTask,Description\n"
+"Task: brazilian-portuguese-desktop\n"
+"Description: Brazilian Portuguese desktop\n"
+" This task localises the desktop in Brasilian Portuguese.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:265
+#, no-wrap
+msgid ""
+"Task: brazilian-portuguese-kde-desktop\n"
+"Description: Brazilian Portuguese KDE desktop\n"
+" This task localises the KDE desktop in Brazilian Portuguese.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:269
+msgid ""
+"We will use the experimental #{--language}# option, as live-build happens to "
+"include #{syslinux}# templates for pt_BR (see {Desktop and language tasks}"
+"#destkop-and-language-tasks for details). And at boot time we will generate "
+"the pt_BR.UTF-8 locale and select the pt-latin1 keyboard layout. Now let's "
+"put the pieces together:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:283
+#, no-wrap
+msgid ""
+"$ mkdir live-pt_BR-kde\n"
+"$ cd live-pt_BR-kde\n"
+"$ lb config \\\n"
+" -a i386 \\\n"
+" -k 486 \\\n"
+" -p kde-desktop \\\n"
+" --language pt_BR \\\n"
+" --tasks \"brazilian-portuguese brazilian-portuguese-desktop brazilian-portuguese-kde-desktop\" \\\n"
+" --bootappend-live \"locales=pt_BR.UTF-8 keyboard-layouts=pt-latin1\"\n"
+" --debian-installer live \\\n"
+" --packages debian-installer-launcher\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:287
+msgid ""
+"Note that we have included the #{debian-installer-launcher}# package to "
+"launch the installer from the live desktop, and have also specified the 486 "
+"flavour kernel, as it is currently necessary to make the installer and live "
+"system kernels match for the launcher to work properly."
+msgstr ""
diff --git a/manual/po/pt_BR/user_examples.ssi.po b/manual/po/pt_BR/user_examples.ssi.po
index 7fb1f9a..f0d1df7 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 2.0~a12\n"
-"POT-Creation-Date: 2010-11-28 07:51-0400\n"
+"POT-Creation-Date: 2010-12-07 18:11-0400\n"
"PO-Revision-Date: 2010-11-04 16:34-0400\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -20,27 +20,19 @@ msgstr ""
#: en/about_manual.ssi:84 en/about_manual.ssi:92 en/about_manual.ssi:100
#: en/about_manual.ssi:108 en/about_manual.ssi:120 en/about_manual.ssi:133
#: en/about_manual.ssi:146 en/about_manual.ssi:154 en/about_manual.ssi:162
-#: en/about_manual.ssi:170 en/other_coding-style.ssi:28
-#: en/other_coding-style.ssi:38 en/other_coding-style.ssi:51
-#: en/other_coding-style.ssi:61 en/other_coding-style.ssi:88
-#: en/other_coding-style.ssi:96 en/other_coding-style.ssi:106
-#: en/other_coding-style.ssi:117 en/other_common-tasks.ssi:32
-#: en/other_customization-backports.ssi:8 en/other_customization-bootup.ssi:30
-#: en/other_customization-bootup.ssi:39 en/other_faq.ssi:41
-#: en/other_faq.ssi:83 en/other_faq.ssi:103 en/other_faq.ssi:117
-#: en/other_faq.ssi:137 en/other_faq.ssi:151 en/other_faq.ssi:198
-#: en/other_faq.ssi:245 en/other_faq.ssi:261 en/other_faq.ssi:287
-#: en/other_faq.ssi:299 en/other_faq.ssi:314 en/other_faq.ssi:333
-#: en/other_faq.ssi:345 en/other_faq.ssi:353 en/other_faq.ssi:364
-#: en/other_faq.ssi:374 en/other_howtos.ssi:16 en/other_howtos.ssi:43
-#: en/other_live-environment.ssi:14 en/other_live-environment.ssi:30
-#: en/other_live-environment.ssi:51 en/other_live-environment.ssi:61
-#: en/other_live-environment.ssi:69 en/other_live-environment.ssi:77
-#: en/other_live-environment.ssi:85 en/other_live-environment.ssi:93
-#: en/other_live-environment.ssi:116 en/other_live-environment.ssi:124
-#: en/other_live-environment.ssi:133 en/other_procedures.ssi:12
-#: en/other_procedures.ssi:46 en/other_procedures.ssi:58
-#: en/project_bugs.ssi:58 en/user_basics.ssi:32 en/user_basics.ssi:42
+#: en/about_manual.ssi:170 en/other_faq.ssi:41 en/other_faq.ssi:83
+#: en/other_faq.ssi:103 en/other_faq.ssi:117 en/other_faq.ssi:137
+#: en/other_faq.ssi:151 en/other_faq.ssi:198 en/other_faq.ssi:245
+#: en/other_faq.ssi:261 en/other_faq.ssi:287 en/other_faq.ssi:299
+#: en/other_faq.ssi:314 en/other_faq.ssi:333 en/other_faq.ssi:345
+#: en/other_faq.ssi:353 en/other_faq.ssi:364 en/other_faq.ssi:374
+#: en/other_howtos.ssi:16 en/other_howtos.ssi:43 en/project_bugs.ssi:58
+#: en/project_coding-style.ssi:28 en/project_coding-style.ssi:38
+#: en/project_coding-style.ssi:51 en/project_coding-style.ssi:61
+#: en/project_coding-style.ssi:92 en/project_coding-style.ssi:100
+#: en/project_coding-style.ssi:110 en/project_coding-style.ssi:121
+#: en/project_procedures.ssi:12 en/project_procedures.ssi:46
+#: en/project_procedures.ssi:58 en/user_basics.ssi:32 en/user_basics.ssi:42
#: en/user_basics.ssi:54 en/user_basics.ssi:66 en/user_basics.ssi:78
#: en/user_basics.ssi:88 en/user_basics.ssi:102 en/user_basics.ssi:110
#: en/user_basics.ssi:118 en/user_basics.ssi:128 en/user_basics.ssi:142
@@ -49,36 +41,43 @@ msgstr ""
#: en/user_basics.ssi:222 en/user_basics.ssi:255 en/user_basics.ssi:271
#: en/user_basics.ssi:279 en/user_basics.ssi:299 en/user_basics.ssi:324
#: en/user_customization-contents.ssi:34 en/user_customization-contents.ssi:43
-#: en/user_customization-contents.ssi:66
-#: en/user_customization-internationalization.ssi:10
-#: en/user_customization-internationalization.ssi:18
-#: en/user_customization-internationalization.ssi:26
-#: en/user_customization-internationalization.ssi:38
-#: en/user_customization-packages.ssi:18 en/user_customization-packages.ssi:31
-#: en/user_customization-packages.ssi:44 en/user_customization-packages.ssi:58
-#: en/user_customization-packages.ssi:72 en/user_customization-packages.ssi:90
-#: en/user_customization-packages.ssi:120
-#: en/user_customization-packages.ssi:133
-#: en/user_customization-packages.ssi:143
-#: en/user_customization-packages.ssi:153
-#: en/user_customization-packages.ssi:163
-#: en/user_customization-packages.ssi:177
-#: en/user_customization-packages.ssi:193
-#: en/user_customization-packages.ssi:261
-#: en/user_customization-packages.ssi:273
-#: en/user_customization-packages.ssi:283 en/user_examples.ssi:14
-#: en/user_examples.ssi:30 en/user_examples.ssi:40 en/user_examples.ssi:54
-#: en/user_examples.ssi:64 en/user_examples.ssi:80 en/user_examples.ssi:90
-#: en/user_examples.ssi:107 en/user_examples.ssi:117 en/user_examples.ssi:131
-#: en/user_examples.ssi:139 en/user_examples.ssi:154 en/user_examples.ssi:162
-#: en/user_examples.ssi:188 en/user_examples.ssi:209 en/user_examples.ssi:217
+#: en/user_customization-contents.ssi:66 en/user_customization-packages.ssi:14
+#: en/user_customization-packages.ssi:22 en/user_customization-packages.ssi:40
+#: en/user_customization-packages.ssi:53 en/user_customization-packages.ssi:66
+#: en/user_customization-packages.ssi:80 en/user_customization-packages.ssi:94
+#: en/user_customization-packages.ssi:112
+#: en/user_customization-packages.ssi:142
+#: en/user_customization-packages.ssi:155
+#: en/user_customization-packages.ssi:165
+#: en/user_customization-packages.ssi:175
+#: en/user_customization-packages.ssi:185
+#: en/user_customization-packages.ssi:199
+#: en/user_customization-packages.ssi:215
+#: en/user_customization-packages.ssi:227
+#: en/user_customization-packages.ssi:290
+#: en/user_customization-packages.ssi:302
+#: en/user_customization-packages.ssi:312
+#: en/user_customization-packages.ssi:330 en/user_customization-runtime.ssi:14
+#: en/user_customization-runtime.ssi:32 en/user_customization-runtime.ssi:42
+#: en/user_customization-runtime.ssi:50 en/user_customization-runtime.ssi:58
+#: en/user_customization-runtime.ssi:66 en/user_customization-runtime.ssi:86
+#: en/user_customization-runtime.ssi:94 en/user_customization-runtime.ssi:103
+#: en/user_examples.ssi:14 en/user_examples.ssi:30 en/user_examples.ssi:40
+#: en/user_examples.ssi:54 en/user_examples.ssi:64 en/user_examples.ssi:80
+#: en/user_examples.ssi:90 en/user_examples.ssi:107 en/user_examples.ssi:117
+#: en/user_examples.ssi:131 en/user_examples.ssi:139 en/user_examples.ssi:154
+#: en/user_examples.ssi:162 en/user_examples.ssi:188 en/user_examples.ssi:209
+#: en/user_examples.ssi:217 en/user_examples.ssi:235 en/user_examples.ssi:243
+#: en/user_examples.ssi:256 en/user_examples.ssi:271
#: 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_installation.ssi:74 en/user_installation.ssi:82
+#: en/user_installation.ssi:90 en/user_installation.ssi:114
+#: en/user_installation.ssi:132 en/user_installation.ssi:147
+#: 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_managing_a_configuration.ssi:47
+#: en/user_managing_a_configuration.ssi:56 en/user_overview.ssi:36
#: en/user_overview.ssi:80 en/user_overview.ssi:88
msgid "code{"
msgstr "code{"
@@ -87,27 +86,19 @@ msgstr "code{"
#: en/about_manual.ssi:88 en/about_manual.ssi:96 en/about_manual.ssi:104
#: en/about_manual.ssi:112 en/about_manual.ssi:129 en/about_manual.ssi:142
#: en/about_manual.ssi:150 en/about_manual.ssi:158 en/about_manual.ssi:166
-#: en/about_manual.ssi:173 en/other_coding-style.ssi:34
-#: en/other_coding-style.ssi:45 en/other_coding-style.ssi:57
-#: en/other_coding-style.ssi:68 en/other_coding-style.ssi:92
-#: en/other_coding-style.ssi:100 en/other_coding-style.ssi:113
-#: en/other_coding-style.ssi:124 en/other_common-tasks.ssi:36
-#: en/other_customization-backports.ssi:16
-#: en/other_customization-bootup.ssi:35 en/other_customization-bootup.ssi:48
-#: en/other_faq.ssi:37 en/other_faq.ssi:46 en/other_faq.ssi:92
-#: en/other_faq.ssi:108 en/other_faq.ssi:141 en/other_faq.ssi:155
-#: en/other_faq.ssi:207 en/other_faq.ssi:256 en/other_faq.ssi:292
-#: en/other_faq.ssi:307 en/other_faq.ssi:319 en/other_faq.ssi:337
-#: en/other_faq.ssi:349 en/other_faq.ssi:358 en/other_faq.ssi:370
-#: en/other_faq.ssi:381 en/other_howtos.ssi:20 en/other_howtos.ssi:47
-#: en/other_live-environment.ssi:18 en/other_live-environment.ssi:34
-#: en/other_live-environment.ssi:55 en/other_live-environment.ssi:65
-#: en/other_live-environment.ssi:73 en/other_live-environment.ssi:81
-#: en/other_live-environment.ssi:89 en/other_live-environment.ssi:97
-#: en/other_live-environment.ssi:120 en/other_live-environment.ssi:129
-#: en/other_live-environment.ssi:138 en/other_procedures.ssi:16
-#: en/other_procedures.ssi:54 en/other_procedures.ssi:131
-#: en/project_bugs.ssi:62 en/user_basics.ssi:36 en/user_basics.ssi:46
+#: en/about_manual.ssi:174 en/other_faq.ssi:37 en/other_faq.ssi:46
+#: en/other_faq.ssi:92 en/other_faq.ssi:108 en/other_faq.ssi:141
+#: en/other_faq.ssi:155 en/other_faq.ssi:207 en/other_faq.ssi:256
+#: en/other_faq.ssi:292 en/other_faq.ssi:307 en/other_faq.ssi:319
+#: en/other_faq.ssi:337 en/other_faq.ssi:349 en/other_faq.ssi:358
+#: en/other_faq.ssi:370 en/other_faq.ssi:381 en/other_howtos.ssi:20
+#: en/other_howtos.ssi:47 en/project_bugs.ssi:62
+#: en/project_coding-style.ssi:34 en/project_coding-style.ssi:45
+#: en/project_coding-style.ssi:57 en/project_coding-style.ssi:68
+#: en/project_coding-style.ssi:96 en/project_coding-style.ssi:104
+#: en/project_coding-style.ssi:117 en/project_coding-style.ssi:128
+#: en/project_procedures.ssi:16 en/project_procedures.ssi:54
+#: en/project_procedures.ssi:131 en/user_basics.ssi:36 en/user_basics.ssi:46
#: en/user_basics.ssi:60 en/user_basics.ssi:72 en/user_basics.ssi:82
#: en/user_basics.ssi:94 en/user_basics.ssi:106 en/user_basics.ssi:114
#: en/user_basics.ssi:122 en/user_basics.ssi:132 en/user_basics.ssi:148
@@ -116,36 +107,42 @@ msgstr "code{"
#: en/user_basics.ssi:247 en/user_basics.ssi:259 en/user_basics.ssi:275
#: en/user_basics.ssi:283 en/user_basics.ssi:310 en/user_basics.ssi:349
#: en/user_customization-contents.ssi:39 en/user_customization-contents.ssi:54
-#: en/user_customization-contents.ssi:70
-#: en/user_customization-internationalization.ssi:14
-#: en/user_customization-internationalization.ssi:22
-#: en/user_customization-internationalization.ssi:30
-#: en/user_customization-internationalization.ssi:42
-#: en/user_customization-packages.ssi:23 en/user_customization-packages.ssi:36
-#: en/user_customization-packages.ssi:48 en/user_customization-packages.ssi:62
-#: en/user_customization-packages.ssi:76 en/user_customization-packages.ssi:94
-#: en/user_customization-packages.ssi:125
-#: en/user_customization-packages.ssi:139
-#: en/user_customization-packages.ssi:149
-#: en/user_customization-packages.ssi:159
-#: en/user_customization-packages.ssi:169
+#: en/user_customization-contents.ssi:70 en/user_customization-packages.ssi:18
+#: en/user_customization-packages.ssi:26 en/user_customization-packages.ssi:45
+#: en/user_customization-packages.ssi:58 en/user_customization-packages.ssi:70
+#: en/user_customization-packages.ssi:84 en/user_customization-packages.ssi:98
+#: en/user_customization-packages.ssi:116
+#: en/user_customization-packages.ssi:147
+#: en/user_customization-packages.ssi:161
+#: en/user_customization-packages.ssi:171
#: en/user_customization-packages.ssi:181
-#: en/user_customization-packages.ssi:197
-#: en/user_customization-packages.ssi:265
-#: en/user_customization-packages.ssi:277
-#: en/user_customization-packages.ssi:287 en/user_examples.ssi:20
-#: en/user_examples.ssi:34 en/user_examples.ssi:44 en/user_examples.ssi:58
-#: en/user_examples.ssi:68 en/user_examples.ssi:86 en/user_examples.ssi:101
-#: en/user_examples.ssi:111 en/user_examples.ssi:123 en/user_examples.ssi:135
-#: en/user_examples.ssi:150 en/user_examples.ssi:158 en/user_examples.ssi:166
-#: en/user_examples.ssi:197 en/user_examples.ssi:213 en/user_examples.ssi:221
+#: en/user_customization-packages.ssi:191
+#: en/user_customization-packages.ssi:203
+#: en/user_customization-packages.ssi:219
+#: en/user_customization-packages.ssi:294
+#: en/user_customization-packages.ssi:306
+#: en/user_customization-packages.ssi:316
+#: en/user_customization-packages.ssi:343 en/user_customization-runtime.ssi:18
+#: en/user_customization-runtime.ssi:36 en/user_customization-runtime.ssi:46
+#: en/user_customization-runtime.ssi:54 en/user_customization-runtime.ssi:62
+#: en/user_customization-runtime.ssi:70 en/user_customization-runtime.ssi:90
+#: en/user_customization-runtime.ssi:99 en/user_customization-runtime.ssi:108
+#: en/user_examples.ssi:20 en/user_examples.ssi:34 en/user_examples.ssi:44
+#: en/user_examples.ssi:58 en/user_examples.ssi:68 en/user_examples.ssi:86
+#: en/user_examples.ssi:101 en/user_examples.ssi:111 en/user_examples.ssi:123
+#: en/user_examples.ssi:135 en/user_examples.ssi:150 en/user_examples.ssi:158
+#: en/user_examples.ssi:166 en/user_examples.ssi:197 en/user_examples.ssi:213
+#: en/user_examples.ssi:221 en/user_examples.ssi:239 en/user_examples.ssi:252
+#: en/user_examples.ssi:267 en/user_examples.ssi:285
#: 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_installation.ssi:60 en/user_installation.ssi:70
+#: en/user_installation.ssi:78 en/user_installation.ssi:86
+#: en/user_installation.ssi:94 en/user_installation.ssi:118
+#: en/user_installation.ssi:137 en/user_installation.ssi:150
+#: 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_managing_a_configuration.ssi:52
+#: en/user_managing_a_configuration.ssi:60 en/user_overview.ssi:74
#: en/user_overview.ssi:84 en/user_overview.ssi:92
msgid "}code"
msgstr "}code"
@@ -222,7 +219,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:24
#, no-wrap
-msgid "*{Use case:}* Create a simple first image, learning the basics of live-build\n"
+msgid "*{Use case:}* Create a simple first image, learning the basics of live-build.\n"
msgstr ""
#. type: Plain text
@@ -283,7 +280,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:50
#, no-wrap
-msgid "*{Use case}* Create a web browser utility image, learning how to apply customizations\n"
+msgid "*{Use case:}* Create a web browser utility image, learning how to apply customizations.\n"
msgstr ""
#. type: Plain text
@@ -334,7 +331,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:74
#, 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"
+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
@@ -499,7 +496,8 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:174
-msgid "Create an image with live-build to boot directly to a VNC server."
+#, no-wrap
+msgid "*{Use case:}* Create an image with live-build to boot directly to a VNC server.\n"
msgstr ""
#. type: Plain text
@@ -568,7 +566,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:205
#, 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"
+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
@@ -622,3 +620,116 @@ msgid ""
"you to decide if the functionality that is sacrificed with each optimization "
"is worth the loss in functionality."
msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:227
+msgid "2~ A localized KDE desktop and installer"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:229
+#, no-wrap
+msgid "*{Use case:}* Create a KDE desktop image, localized for Brazilian Portuguese and including an installer.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:231
+msgid ""
+"We want to make an iso-hybrid image for i386 architecture using our "
+"preferred desktop, in this case KDE, containing all of the same packages "
+"that would be installed by the standard Debian installer for KDE."
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:233
+msgid ""
+"Our initial problem is the discovery of the names of the appropriate tasks. "
+"Currently, live-build cannot help with this. While we might get lucky and "
+"find this by trial-and-error, there is a tool, #{grep-dctrl}#, which can be "
+"used to dig it out of the task descriptions in tasksel-data, so to prepare, "
+"make sure you have both of those things:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:237
+msgid "# apt-get install dctrl-tools tasksel-data"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:241
+msgid "Now we can search for the appropriate tasks, first with:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:250
+#, no-wrap
+msgid ""
+"$ grep-dctrl -FTest-lang pt_BR /usr/share/tasksel/debian-tasks.desc -sTask,Description\n"
+"Task: brazilian-portuguese\n"
+"Description: Brazilian Portuguese environment\n"
+" This task installs programs, data files, and\n"
+" documentation that make it easier for Brazilian Portuguese speakers\n"
+" to use Debian.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:254
+msgid ""
+"By this command, we discover the task is called, plainly enough, brazilian-"
+"portuguese. Now to find the related tasks:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:261
+#, no-wrap
+msgid ""
+"$ grep-dctrl -FEnhances brazilian-portuguese /usr/share/tasksel/debian-tasks.desc -sTask,Description\n"
+"Task: brazilian-portuguese-desktop\n"
+"Description: Brazilian Portuguese desktop\n"
+" This task localises the desktop in Brasilian Portuguese.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:265
+#, no-wrap
+msgid ""
+"Task: brazilian-portuguese-kde-desktop\n"
+"Description: Brazilian Portuguese KDE desktop\n"
+" This task localises the KDE desktop in Brazilian Portuguese.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:269
+msgid ""
+"We will use the experimental #{--language}# option, as live-build happens to "
+"include #{syslinux}# templates for pt_BR (see {Desktop and language tasks}"
+"#destkop-and-language-tasks for details). And at boot time we will generate "
+"the pt_BR.UTF-8 locale and select the pt-latin1 keyboard layout. Now let's "
+"put the pieces together:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:283
+#, no-wrap
+msgid ""
+"$ mkdir live-pt_BR-kde\n"
+"$ cd live-pt_BR-kde\n"
+"$ lb config \\\n"
+" -a i386 \\\n"
+" -k 486 \\\n"
+" -p kde-desktop \\\n"
+" --language pt_BR \\\n"
+" --tasks \"brazilian-portuguese brazilian-portuguese-desktop brazilian-portuguese-kde-desktop\" \\\n"
+" --bootappend-live \"locales=pt_BR.UTF-8 keyboard-layouts=pt-latin1\"\n"
+" --debian-installer live \\\n"
+" --packages debian-installer-launcher\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:287
+msgid ""
+"Note that we have included the #{debian-installer-launcher}# package to "
+"launch the installer from the live desktop, and have also specified the 486 "
+"flavour kernel, as it is currently necessary to make the installer and live "
+"system kernels match for the launcher to work properly."
+msgstr ""
diff --git a/manual/po/ro/user_examples.ssi.po b/manual/po/ro/user_examples.ssi.po
index 8bea630..89eae31 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 2.0~a12\n"
-"POT-Creation-Date: 2010-11-28 07:51-0400\n"
+"POT-Creation-Date: 2010-12-07 18:11-0400\n"
"PO-Revision-Date: 2010-11-04 16:34-0400\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -21,27 +21,19 @@ msgstr ""
#: en/about_manual.ssi:84 en/about_manual.ssi:92 en/about_manual.ssi:100
#: en/about_manual.ssi:108 en/about_manual.ssi:120 en/about_manual.ssi:133
#: en/about_manual.ssi:146 en/about_manual.ssi:154 en/about_manual.ssi:162
-#: en/about_manual.ssi:170 en/other_coding-style.ssi:28
-#: en/other_coding-style.ssi:38 en/other_coding-style.ssi:51
-#: en/other_coding-style.ssi:61 en/other_coding-style.ssi:88
-#: en/other_coding-style.ssi:96 en/other_coding-style.ssi:106
-#: en/other_coding-style.ssi:117 en/other_common-tasks.ssi:32
-#: en/other_customization-backports.ssi:8 en/other_customization-bootup.ssi:30
-#: en/other_customization-bootup.ssi:39 en/other_faq.ssi:41
-#: en/other_faq.ssi:83 en/other_faq.ssi:103 en/other_faq.ssi:117
-#: en/other_faq.ssi:137 en/other_faq.ssi:151 en/other_faq.ssi:198
-#: en/other_faq.ssi:245 en/other_faq.ssi:261 en/other_faq.ssi:287
-#: en/other_faq.ssi:299 en/other_faq.ssi:314 en/other_faq.ssi:333
-#: en/other_faq.ssi:345 en/other_faq.ssi:353 en/other_faq.ssi:364
-#: en/other_faq.ssi:374 en/other_howtos.ssi:16 en/other_howtos.ssi:43
-#: en/other_live-environment.ssi:14 en/other_live-environment.ssi:30
-#: en/other_live-environment.ssi:51 en/other_live-environment.ssi:61
-#: en/other_live-environment.ssi:69 en/other_live-environment.ssi:77
-#: en/other_live-environment.ssi:85 en/other_live-environment.ssi:93
-#: en/other_live-environment.ssi:116 en/other_live-environment.ssi:124
-#: en/other_live-environment.ssi:133 en/other_procedures.ssi:12
-#: en/other_procedures.ssi:46 en/other_procedures.ssi:58
-#: en/project_bugs.ssi:58 en/user_basics.ssi:32 en/user_basics.ssi:42
+#: en/about_manual.ssi:170 en/other_faq.ssi:41 en/other_faq.ssi:83
+#: en/other_faq.ssi:103 en/other_faq.ssi:117 en/other_faq.ssi:137
+#: en/other_faq.ssi:151 en/other_faq.ssi:198 en/other_faq.ssi:245
+#: en/other_faq.ssi:261 en/other_faq.ssi:287 en/other_faq.ssi:299
+#: en/other_faq.ssi:314 en/other_faq.ssi:333 en/other_faq.ssi:345
+#: en/other_faq.ssi:353 en/other_faq.ssi:364 en/other_faq.ssi:374
+#: en/other_howtos.ssi:16 en/other_howtos.ssi:43 en/project_bugs.ssi:58
+#: en/project_coding-style.ssi:28 en/project_coding-style.ssi:38
+#: en/project_coding-style.ssi:51 en/project_coding-style.ssi:61
+#: en/project_coding-style.ssi:92 en/project_coding-style.ssi:100
+#: en/project_coding-style.ssi:110 en/project_coding-style.ssi:121
+#: en/project_procedures.ssi:12 en/project_procedures.ssi:46
+#: en/project_procedures.ssi:58 en/user_basics.ssi:32 en/user_basics.ssi:42
#: en/user_basics.ssi:54 en/user_basics.ssi:66 en/user_basics.ssi:78
#: en/user_basics.ssi:88 en/user_basics.ssi:102 en/user_basics.ssi:110
#: en/user_basics.ssi:118 en/user_basics.ssi:128 en/user_basics.ssi:142
@@ -50,36 +42,43 @@ msgstr ""
#: en/user_basics.ssi:222 en/user_basics.ssi:255 en/user_basics.ssi:271
#: en/user_basics.ssi:279 en/user_basics.ssi:299 en/user_basics.ssi:324
#: en/user_customization-contents.ssi:34 en/user_customization-contents.ssi:43
-#: en/user_customization-contents.ssi:66
-#: en/user_customization-internationalization.ssi:10
-#: en/user_customization-internationalization.ssi:18
-#: en/user_customization-internationalization.ssi:26
-#: en/user_customization-internationalization.ssi:38
-#: en/user_customization-packages.ssi:18 en/user_customization-packages.ssi:31
-#: en/user_customization-packages.ssi:44 en/user_customization-packages.ssi:58
-#: en/user_customization-packages.ssi:72 en/user_customization-packages.ssi:90
-#: en/user_customization-packages.ssi:120
-#: en/user_customization-packages.ssi:133
-#: en/user_customization-packages.ssi:143
-#: en/user_customization-packages.ssi:153
-#: en/user_customization-packages.ssi:163
-#: en/user_customization-packages.ssi:177
-#: en/user_customization-packages.ssi:193
-#: en/user_customization-packages.ssi:261
-#: en/user_customization-packages.ssi:273
-#: en/user_customization-packages.ssi:283 en/user_examples.ssi:14
-#: en/user_examples.ssi:30 en/user_examples.ssi:40 en/user_examples.ssi:54
-#: en/user_examples.ssi:64 en/user_examples.ssi:80 en/user_examples.ssi:90
-#: en/user_examples.ssi:107 en/user_examples.ssi:117 en/user_examples.ssi:131
-#: en/user_examples.ssi:139 en/user_examples.ssi:154 en/user_examples.ssi:162
-#: en/user_examples.ssi:188 en/user_examples.ssi:209 en/user_examples.ssi:217
+#: en/user_customization-contents.ssi:66 en/user_customization-packages.ssi:14
+#: en/user_customization-packages.ssi:22 en/user_customization-packages.ssi:40
+#: en/user_customization-packages.ssi:53 en/user_customization-packages.ssi:66
+#: en/user_customization-packages.ssi:80 en/user_customization-packages.ssi:94
+#: en/user_customization-packages.ssi:112
+#: en/user_customization-packages.ssi:142
+#: en/user_customization-packages.ssi:155
+#: en/user_customization-packages.ssi:165
+#: en/user_customization-packages.ssi:175
+#: en/user_customization-packages.ssi:185
+#: en/user_customization-packages.ssi:199
+#: en/user_customization-packages.ssi:215
+#: en/user_customization-packages.ssi:227
+#: en/user_customization-packages.ssi:290
+#: en/user_customization-packages.ssi:302
+#: en/user_customization-packages.ssi:312
+#: en/user_customization-packages.ssi:330 en/user_customization-runtime.ssi:14
+#: en/user_customization-runtime.ssi:32 en/user_customization-runtime.ssi:42
+#: en/user_customization-runtime.ssi:50 en/user_customization-runtime.ssi:58
+#: en/user_customization-runtime.ssi:66 en/user_customization-runtime.ssi:86
+#: en/user_customization-runtime.ssi:94 en/user_customization-runtime.ssi:103
+#: en/user_examples.ssi:14 en/user_examples.ssi:30 en/user_examples.ssi:40
+#: en/user_examples.ssi:54 en/user_examples.ssi:64 en/user_examples.ssi:80
+#: en/user_examples.ssi:90 en/user_examples.ssi:107 en/user_examples.ssi:117
+#: en/user_examples.ssi:131 en/user_examples.ssi:139 en/user_examples.ssi:154
+#: en/user_examples.ssi:162 en/user_examples.ssi:188 en/user_examples.ssi:209
+#: en/user_examples.ssi:217 en/user_examples.ssi:235 en/user_examples.ssi:243
+#: en/user_examples.ssi:256 en/user_examples.ssi:271
#: 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_installation.ssi:74 en/user_installation.ssi:82
+#: en/user_installation.ssi:90 en/user_installation.ssi:114
+#: en/user_installation.ssi:132 en/user_installation.ssi:147
+#: 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_managing_a_configuration.ssi:47
+#: en/user_managing_a_configuration.ssi:56 en/user_overview.ssi:36
#: en/user_overview.ssi:80 en/user_overview.ssi:88
msgid "code{"
msgstr "code{"
@@ -88,27 +87,19 @@ msgstr "code{"
#: en/about_manual.ssi:88 en/about_manual.ssi:96 en/about_manual.ssi:104
#: en/about_manual.ssi:112 en/about_manual.ssi:129 en/about_manual.ssi:142
#: en/about_manual.ssi:150 en/about_manual.ssi:158 en/about_manual.ssi:166
-#: en/about_manual.ssi:173 en/other_coding-style.ssi:34
-#: en/other_coding-style.ssi:45 en/other_coding-style.ssi:57
-#: en/other_coding-style.ssi:68 en/other_coding-style.ssi:92
-#: en/other_coding-style.ssi:100 en/other_coding-style.ssi:113
-#: en/other_coding-style.ssi:124 en/other_common-tasks.ssi:36
-#: en/other_customization-backports.ssi:16
-#: en/other_customization-bootup.ssi:35 en/other_customization-bootup.ssi:48
-#: en/other_faq.ssi:37 en/other_faq.ssi:46 en/other_faq.ssi:92
-#: en/other_faq.ssi:108 en/other_faq.ssi:141 en/other_faq.ssi:155
-#: en/other_faq.ssi:207 en/other_faq.ssi:256 en/other_faq.ssi:292
-#: en/other_faq.ssi:307 en/other_faq.ssi:319 en/other_faq.ssi:337
-#: en/other_faq.ssi:349 en/other_faq.ssi:358 en/other_faq.ssi:370
-#: en/other_faq.ssi:381 en/other_howtos.ssi:20 en/other_howtos.ssi:47
-#: en/other_live-environment.ssi:18 en/other_live-environment.ssi:34
-#: en/other_live-environment.ssi:55 en/other_live-environment.ssi:65
-#: en/other_live-environment.ssi:73 en/other_live-environment.ssi:81
-#: en/other_live-environment.ssi:89 en/other_live-environment.ssi:97
-#: en/other_live-environment.ssi:120 en/other_live-environment.ssi:129
-#: en/other_live-environment.ssi:138 en/other_procedures.ssi:16
-#: en/other_procedures.ssi:54 en/other_procedures.ssi:131
-#: en/project_bugs.ssi:62 en/user_basics.ssi:36 en/user_basics.ssi:46
+#: en/about_manual.ssi:174 en/other_faq.ssi:37 en/other_faq.ssi:46
+#: en/other_faq.ssi:92 en/other_faq.ssi:108 en/other_faq.ssi:141
+#: en/other_faq.ssi:155 en/other_faq.ssi:207 en/other_faq.ssi:256
+#: en/other_faq.ssi:292 en/other_faq.ssi:307 en/other_faq.ssi:319
+#: en/other_faq.ssi:337 en/other_faq.ssi:349 en/other_faq.ssi:358
+#: en/other_faq.ssi:370 en/other_faq.ssi:381 en/other_howtos.ssi:20
+#: en/other_howtos.ssi:47 en/project_bugs.ssi:62
+#: en/project_coding-style.ssi:34 en/project_coding-style.ssi:45
+#: en/project_coding-style.ssi:57 en/project_coding-style.ssi:68
+#: en/project_coding-style.ssi:96 en/project_coding-style.ssi:104
+#: en/project_coding-style.ssi:117 en/project_coding-style.ssi:128
+#: en/project_procedures.ssi:16 en/project_procedures.ssi:54
+#: en/project_procedures.ssi:131 en/user_basics.ssi:36 en/user_basics.ssi:46
#: en/user_basics.ssi:60 en/user_basics.ssi:72 en/user_basics.ssi:82
#: en/user_basics.ssi:94 en/user_basics.ssi:106 en/user_basics.ssi:114
#: en/user_basics.ssi:122 en/user_basics.ssi:132 en/user_basics.ssi:148
@@ -117,36 +108,42 @@ msgstr "code{"
#: en/user_basics.ssi:247 en/user_basics.ssi:259 en/user_basics.ssi:275
#: en/user_basics.ssi:283 en/user_basics.ssi:310 en/user_basics.ssi:349
#: en/user_customization-contents.ssi:39 en/user_customization-contents.ssi:54
-#: en/user_customization-contents.ssi:70
-#: en/user_customization-internationalization.ssi:14
-#: en/user_customization-internationalization.ssi:22
-#: en/user_customization-internationalization.ssi:30
-#: en/user_customization-internationalization.ssi:42
-#: en/user_customization-packages.ssi:23 en/user_customization-packages.ssi:36
-#: en/user_customization-packages.ssi:48 en/user_customization-packages.ssi:62
-#: en/user_customization-packages.ssi:76 en/user_customization-packages.ssi:94
-#: en/user_customization-packages.ssi:125
-#: en/user_customization-packages.ssi:139
-#: en/user_customization-packages.ssi:149
-#: en/user_customization-packages.ssi:159
-#: en/user_customization-packages.ssi:169
+#: en/user_customization-contents.ssi:70 en/user_customization-packages.ssi:18
+#: en/user_customization-packages.ssi:26 en/user_customization-packages.ssi:45
+#: en/user_customization-packages.ssi:58 en/user_customization-packages.ssi:70
+#: en/user_customization-packages.ssi:84 en/user_customization-packages.ssi:98
+#: en/user_customization-packages.ssi:116
+#: en/user_customization-packages.ssi:147
+#: en/user_customization-packages.ssi:161
+#: en/user_customization-packages.ssi:171
#: en/user_customization-packages.ssi:181
-#: en/user_customization-packages.ssi:197
-#: en/user_customization-packages.ssi:265
-#: en/user_customization-packages.ssi:277
-#: en/user_customization-packages.ssi:287 en/user_examples.ssi:20
-#: en/user_examples.ssi:34 en/user_examples.ssi:44 en/user_examples.ssi:58
-#: en/user_examples.ssi:68 en/user_examples.ssi:86 en/user_examples.ssi:101
-#: en/user_examples.ssi:111 en/user_examples.ssi:123 en/user_examples.ssi:135
-#: en/user_examples.ssi:150 en/user_examples.ssi:158 en/user_examples.ssi:166
-#: en/user_examples.ssi:197 en/user_examples.ssi:213 en/user_examples.ssi:221
+#: en/user_customization-packages.ssi:191
+#: en/user_customization-packages.ssi:203
+#: en/user_customization-packages.ssi:219
+#: en/user_customization-packages.ssi:294
+#: en/user_customization-packages.ssi:306
+#: en/user_customization-packages.ssi:316
+#: en/user_customization-packages.ssi:343 en/user_customization-runtime.ssi:18
+#: en/user_customization-runtime.ssi:36 en/user_customization-runtime.ssi:46
+#: en/user_customization-runtime.ssi:54 en/user_customization-runtime.ssi:62
+#: en/user_customization-runtime.ssi:70 en/user_customization-runtime.ssi:90
+#: en/user_customization-runtime.ssi:99 en/user_customization-runtime.ssi:108
+#: en/user_examples.ssi:20 en/user_examples.ssi:34 en/user_examples.ssi:44
+#: en/user_examples.ssi:58 en/user_examples.ssi:68 en/user_examples.ssi:86
+#: en/user_examples.ssi:101 en/user_examples.ssi:111 en/user_examples.ssi:123
+#: en/user_examples.ssi:135 en/user_examples.ssi:150 en/user_examples.ssi:158
+#: en/user_examples.ssi:166 en/user_examples.ssi:197 en/user_examples.ssi:213
+#: en/user_examples.ssi:221 en/user_examples.ssi:239 en/user_examples.ssi:252
+#: en/user_examples.ssi:267 en/user_examples.ssi:285
#: 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_installation.ssi:60 en/user_installation.ssi:70
+#: en/user_installation.ssi:78 en/user_installation.ssi:86
+#: en/user_installation.ssi:94 en/user_installation.ssi:118
+#: en/user_installation.ssi:137 en/user_installation.ssi:150
+#: 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_managing_a_configuration.ssi:52
+#: en/user_managing_a_configuration.ssi:60 en/user_overview.ssi:74
#: en/user_overview.ssi:84 en/user_overview.ssi:92
msgid "}code"
msgstr "}code"
@@ -223,7 +220,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:24
#, no-wrap
-msgid "*{Use case:}* Create a simple first image, learning the basics of live-build\n"
+msgid "*{Use case:}* Create a simple first image, learning the basics of live-build.\n"
msgstr ""
#. type: Plain text
@@ -284,7 +281,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:50
#, no-wrap
-msgid "*{Use case}* Create a web browser utility image, learning how to apply customizations\n"
+msgid "*{Use case:}* Create a web browser utility image, learning how to apply customizations.\n"
msgstr ""
#. type: Plain text
@@ -335,7 +332,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:74
#, 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"
+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
@@ -500,7 +497,8 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:174
-msgid "Create an image with live-build to boot directly to a VNC server."
+#, no-wrap
+msgid "*{Use case:}* Create an image with live-build to boot directly to a VNC server.\n"
msgstr ""
#. type: Plain text
@@ -569,7 +567,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:205
#, 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"
+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
@@ -623,3 +621,116 @@ msgid ""
"you to decide if the functionality that is sacrificed with each optimization "
"is worth the loss in functionality."
msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:227
+msgid "2~ A localized KDE desktop and installer"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:229
+#, no-wrap
+msgid "*{Use case:}* Create a KDE desktop image, localized for Brazilian Portuguese and including an installer.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:231
+msgid ""
+"We want to make an iso-hybrid image for i386 architecture using our "
+"preferred desktop, in this case KDE, containing all of the same packages "
+"that would be installed by the standard Debian installer for KDE."
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:233
+msgid ""
+"Our initial problem is the discovery of the names of the appropriate tasks. "
+"Currently, live-build cannot help with this. While we might get lucky and "
+"find this by trial-and-error, there is a tool, #{grep-dctrl}#, which can be "
+"used to dig it out of the task descriptions in tasksel-data, so to prepare, "
+"make sure you have both of those things:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:237
+msgid "# apt-get install dctrl-tools tasksel-data"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:241
+msgid "Now we can search for the appropriate tasks, first with:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:250
+#, no-wrap
+msgid ""
+"$ grep-dctrl -FTest-lang pt_BR /usr/share/tasksel/debian-tasks.desc -sTask,Description\n"
+"Task: brazilian-portuguese\n"
+"Description: Brazilian Portuguese environment\n"
+" This task installs programs, data files, and\n"
+" documentation that make it easier for Brazilian Portuguese speakers\n"
+" to use Debian.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:254
+msgid ""
+"By this command, we discover the task is called, plainly enough, brazilian-"
+"portuguese. Now to find the related tasks:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:261
+#, no-wrap
+msgid ""
+"$ grep-dctrl -FEnhances brazilian-portuguese /usr/share/tasksel/debian-tasks.desc -sTask,Description\n"
+"Task: brazilian-portuguese-desktop\n"
+"Description: Brazilian Portuguese desktop\n"
+" This task localises the desktop in Brasilian Portuguese.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:265
+#, no-wrap
+msgid ""
+"Task: brazilian-portuguese-kde-desktop\n"
+"Description: Brazilian Portuguese KDE desktop\n"
+" This task localises the KDE desktop in Brazilian Portuguese.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:269
+msgid ""
+"We will use the experimental #{--language}# option, as live-build happens to "
+"include #{syslinux}# templates for pt_BR (see {Desktop and language tasks}"
+"#destkop-and-language-tasks for details). And at boot time we will generate "
+"the pt_BR.UTF-8 locale and select the pt-latin1 keyboard layout. Now let's "
+"put the pieces together:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:283
+#, no-wrap
+msgid ""
+"$ mkdir live-pt_BR-kde\n"
+"$ cd live-pt_BR-kde\n"
+"$ lb config \\\n"
+" -a i386 \\\n"
+" -k 486 \\\n"
+" -p kde-desktop \\\n"
+" --language pt_BR \\\n"
+" --tasks \"brazilian-portuguese brazilian-portuguese-desktop brazilian-portuguese-kde-desktop\" \\\n"
+" --bootappend-live \"locales=pt_BR.UTF-8 keyboard-layouts=pt-latin1\"\n"
+" --debian-installer live \\\n"
+" --packages debian-installer-launcher\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:287
+msgid ""
+"Note that we have included the #{debian-installer-launcher}# package to "
+"launch the installer from the live desktop, and have also specified the 486 "
+"flavour kernel, as it is currently necessary to make the installer and live "
+"system kernels match for the launcher to work properly."
+msgstr ""
diff --git a/manual/pot/user_examples.ssi.pot b/manual/pot/user_examples.ssi.pot
index 6f98511..124678b 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-28 07:51-0400\n"
+"POT-Creation-Date: 2010-12-07 18:11-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"
@@ -20,27 +20,19 @@ msgstr ""
#: en/about_manual.ssi:84 en/about_manual.ssi:92 en/about_manual.ssi:100
#: en/about_manual.ssi:108 en/about_manual.ssi:120 en/about_manual.ssi:133
#: en/about_manual.ssi:146 en/about_manual.ssi:154 en/about_manual.ssi:162
-#: en/about_manual.ssi:170 en/other_coding-style.ssi:28
-#: en/other_coding-style.ssi:38 en/other_coding-style.ssi:51
-#: en/other_coding-style.ssi:61 en/other_coding-style.ssi:88
-#: en/other_coding-style.ssi:96 en/other_coding-style.ssi:106
-#: en/other_coding-style.ssi:117 en/other_common-tasks.ssi:32
-#: en/other_customization-backports.ssi:8 en/other_customization-bootup.ssi:30
-#: en/other_customization-bootup.ssi:39 en/other_faq.ssi:41
-#: en/other_faq.ssi:83 en/other_faq.ssi:103 en/other_faq.ssi:117
-#: en/other_faq.ssi:137 en/other_faq.ssi:151 en/other_faq.ssi:198
-#: en/other_faq.ssi:245 en/other_faq.ssi:261 en/other_faq.ssi:287
-#: en/other_faq.ssi:299 en/other_faq.ssi:314 en/other_faq.ssi:333
-#: en/other_faq.ssi:345 en/other_faq.ssi:353 en/other_faq.ssi:364
-#: en/other_faq.ssi:374 en/other_howtos.ssi:16 en/other_howtos.ssi:43
-#: en/other_live-environment.ssi:14 en/other_live-environment.ssi:30
-#: en/other_live-environment.ssi:51 en/other_live-environment.ssi:61
-#: en/other_live-environment.ssi:69 en/other_live-environment.ssi:77
-#: en/other_live-environment.ssi:85 en/other_live-environment.ssi:93
-#: en/other_live-environment.ssi:116 en/other_live-environment.ssi:124
-#: en/other_live-environment.ssi:133 en/other_procedures.ssi:12
-#: en/other_procedures.ssi:46 en/other_procedures.ssi:58
-#: en/project_bugs.ssi:58 en/user_basics.ssi:32 en/user_basics.ssi:42
+#: en/about_manual.ssi:170 en/other_faq.ssi:41 en/other_faq.ssi:83
+#: en/other_faq.ssi:103 en/other_faq.ssi:117 en/other_faq.ssi:137
+#: en/other_faq.ssi:151 en/other_faq.ssi:198 en/other_faq.ssi:245
+#: en/other_faq.ssi:261 en/other_faq.ssi:287 en/other_faq.ssi:299
+#: en/other_faq.ssi:314 en/other_faq.ssi:333 en/other_faq.ssi:345
+#: en/other_faq.ssi:353 en/other_faq.ssi:364 en/other_faq.ssi:374
+#: en/other_howtos.ssi:16 en/other_howtos.ssi:43 en/project_bugs.ssi:58
+#: en/project_coding-style.ssi:28 en/project_coding-style.ssi:38
+#: en/project_coding-style.ssi:51 en/project_coding-style.ssi:61
+#: en/project_coding-style.ssi:92 en/project_coding-style.ssi:100
+#: en/project_coding-style.ssi:110 en/project_coding-style.ssi:121
+#: en/project_procedures.ssi:12 en/project_procedures.ssi:46
+#: en/project_procedures.ssi:58 en/user_basics.ssi:32 en/user_basics.ssi:42
#: en/user_basics.ssi:54 en/user_basics.ssi:66 en/user_basics.ssi:78
#: en/user_basics.ssi:88 en/user_basics.ssi:102 en/user_basics.ssi:110
#: en/user_basics.ssi:118 en/user_basics.ssi:128 en/user_basics.ssi:142
@@ -49,36 +41,43 @@ msgstr ""
#: en/user_basics.ssi:222 en/user_basics.ssi:255 en/user_basics.ssi:271
#: en/user_basics.ssi:279 en/user_basics.ssi:299 en/user_basics.ssi:324
#: en/user_customization-contents.ssi:34 en/user_customization-contents.ssi:43
-#: en/user_customization-contents.ssi:66
-#: en/user_customization-internationalization.ssi:10
-#: en/user_customization-internationalization.ssi:18
-#: en/user_customization-internationalization.ssi:26
-#: en/user_customization-internationalization.ssi:38
-#: en/user_customization-packages.ssi:18 en/user_customization-packages.ssi:31
-#: en/user_customization-packages.ssi:44 en/user_customization-packages.ssi:58
-#: en/user_customization-packages.ssi:72 en/user_customization-packages.ssi:90
-#: en/user_customization-packages.ssi:120
-#: en/user_customization-packages.ssi:133
-#: en/user_customization-packages.ssi:143
-#: en/user_customization-packages.ssi:153
-#: en/user_customization-packages.ssi:163
-#: en/user_customization-packages.ssi:177
-#: en/user_customization-packages.ssi:193
-#: en/user_customization-packages.ssi:261
-#: en/user_customization-packages.ssi:273
-#: en/user_customization-packages.ssi:283 en/user_examples.ssi:14
-#: en/user_examples.ssi:30 en/user_examples.ssi:40 en/user_examples.ssi:54
-#: en/user_examples.ssi:64 en/user_examples.ssi:80 en/user_examples.ssi:90
-#: en/user_examples.ssi:107 en/user_examples.ssi:117 en/user_examples.ssi:131
-#: en/user_examples.ssi:139 en/user_examples.ssi:154 en/user_examples.ssi:162
-#: en/user_examples.ssi:188 en/user_examples.ssi:209 en/user_examples.ssi:217
+#: en/user_customization-contents.ssi:66 en/user_customization-packages.ssi:14
+#: en/user_customization-packages.ssi:22 en/user_customization-packages.ssi:40
+#: en/user_customization-packages.ssi:53 en/user_customization-packages.ssi:66
+#: en/user_customization-packages.ssi:80 en/user_customization-packages.ssi:94
+#: en/user_customization-packages.ssi:112
+#: en/user_customization-packages.ssi:142
+#: en/user_customization-packages.ssi:155
+#: en/user_customization-packages.ssi:165
+#: en/user_customization-packages.ssi:175
+#: en/user_customization-packages.ssi:185
+#: en/user_customization-packages.ssi:199
+#: en/user_customization-packages.ssi:215
+#: en/user_customization-packages.ssi:227
+#: en/user_customization-packages.ssi:290
+#: en/user_customization-packages.ssi:302
+#: en/user_customization-packages.ssi:312
+#: en/user_customization-packages.ssi:330 en/user_customization-runtime.ssi:14
+#: en/user_customization-runtime.ssi:32 en/user_customization-runtime.ssi:42
+#: en/user_customization-runtime.ssi:50 en/user_customization-runtime.ssi:58
+#: en/user_customization-runtime.ssi:66 en/user_customization-runtime.ssi:86
+#: en/user_customization-runtime.ssi:94 en/user_customization-runtime.ssi:103
+#: en/user_examples.ssi:14 en/user_examples.ssi:30 en/user_examples.ssi:40
+#: en/user_examples.ssi:54 en/user_examples.ssi:64 en/user_examples.ssi:80
+#: en/user_examples.ssi:90 en/user_examples.ssi:107 en/user_examples.ssi:117
+#: en/user_examples.ssi:131 en/user_examples.ssi:139 en/user_examples.ssi:154
+#: en/user_examples.ssi:162 en/user_examples.ssi:188 en/user_examples.ssi:209
+#: en/user_examples.ssi:217 en/user_examples.ssi:235 en/user_examples.ssi:243
+#: en/user_examples.ssi:256 en/user_examples.ssi:271
#: 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_installation.ssi:74 en/user_installation.ssi:82
+#: en/user_installation.ssi:90 en/user_installation.ssi:114
+#: en/user_installation.ssi:132 en/user_installation.ssi:147
+#: 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_managing_a_configuration.ssi:47
+#: en/user_managing_a_configuration.ssi:56 en/user_overview.ssi:36
#: en/user_overview.ssi:80 en/user_overview.ssi:88
msgid "code{"
msgstr ""
@@ -87,27 +86,19 @@ msgstr ""
#: en/about_manual.ssi:88 en/about_manual.ssi:96 en/about_manual.ssi:104
#: en/about_manual.ssi:112 en/about_manual.ssi:129 en/about_manual.ssi:142
#: en/about_manual.ssi:150 en/about_manual.ssi:158 en/about_manual.ssi:166
-#: en/about_manual.ssi:173 en/other_coding-style.ssi:34
-#: en/other_coding-style.ssi:45 en/other_coding-style.ssi:57
-#: en/other_coding-style.ssi:68 en/other_coding-style.ssi:92
-#: en/other_coding-style.ssi:100 en/other_coding-style.ssi:113
-#: en/other_coding-style.ssi:124 en/other_common-tasks.ssi:36
-#: en/other_customization-backports.ssi:16
-#: en/other_customization-bootup.ssi:35 en/other_customization-bootup.ssi:48
-#: en/other_faq.ssi:37 en/other_faq.ssi:46 en/other_faq.ssi:92
-#: en/other_faq.ssi:108 en/other_faq.ssi:141 en/other_faq.ssi:155
-#: en/other_faq.ssi:207 en/other_faq.ssi:256 en/other_faq.ssi:292
-#: en/other_faq.ssi:307 en/other_faq.ssi:319 en/other_faq.ssi:337
-#: en/other_faq.ssi:349 en/other_faq.ssi:358 en/other_faq.ssi:370
-#: en/other_faq.ssi:381 en/other_howtos.ssi:20 en/other_howtos.ssi:47
-#: en/other_live-environment.ssi:18 en/other_live-environment.ssi:34
-#: en/other_live-environment.ssi:55 en/other_live-environment.ssi:65
-#: en/other_live-environment.ssi:73 en/other_live-environment.ssi:81
-#: en/other_live-environment.ssi:89 en/other_live-environment.ssi:97
-#: en/other_live-environment.ssi:120 en/other_live-environment.ssi:129
-#: en/other_live-environment.ssi:138 en/other_procedures.ssi:16
-#: en/other_procedures.ssi:54 en/other_procedures.ssi:131
-#: en/project_bugs.ssi:62 en/user_basics.ssi:36 en/user_basics.ssi:46
+#: en/about_manual.ssi:174 en/other_faq.ssi:37 en/other_faq.ssi:46
+#: en/other_faq.ssi:92 en/other_faq.ssi:108 en/other_faq.ssi:141
+#: en/other_faq.ssi:155 en/other_faq.ssi:207 en/other_faq.ssi:256
+#: en/other_faq.ssi:292 en/other_faq.ssi:307 en/other_faq.ssi:319
+#: en/other_faq.ssi:337 en/other_faq.ssi:349 en/other_faq.ssi:358
+#: en/other_faq.ssi:370 en/other_faq.ssi:381 en/other_howtos.ssi:20
+#: en/other_howtos.ssi:47 en/project_bugs.ssi:62
+#: en/project_coding-style.ssi:34 en/project_coding-style.ssi:45
+#: en/project_coding-style.ssi:57 en/project_coding-style.ssi:68
+#: en/project_coding-style.ssi:96 en/project_coding-style.ssi:104
+#: en/project_coding-style.ssi:117 en/project_coding-style.ssi:128
+#: en/project_procedures.ssi:16 en/project_procedures.ssi:54
+#: en/project_procedures.ssi:131 en/user_basics.ssi:36 en/user_basics.ssi:46
#: en/user_basics.ssi:60 en/user_basics.ssi:72 en/user_basics.ssi:82
#: en/user_basics.ssi:94 en/user_basics.ssi:106 en/user_basics.ssi:114
#: en/user_basics.ssi:122 en/user_basics.ssi:132 en/user_basics.ssi:148
@@ -116,36 +107,42 @@ msgstr ""
#: en/user_basics.ssi:247 en/user_basics.ssi:259 en/user_basics.ssi:275
#: en/user_basics.ssi:283 en/user_basics.ssi:310 en/user_basics.ssi:349
#: en/user_customization-contents.ssi:39 en/user_customization-contents.ssi:54
-#: en/user_customization-contents.ssi:70
-#: en/user_customization-internationalization.ssi:14
-#: en/user_customization-internationalization.ssi:22
-#: en/user_customization-internationalization.ssi:30
-#: en/user_customization-internationalization.ssi:42
-#: en/user_customization-packages.ssi:23 en/user_customization-packages.ssi:36
-#: en/user_customization-packages.ssi:48 en/user_customization-packages.ssi:62
-#: en/user_customization-packages.ssi:76 en/user_customization-packages.ssi:94
-#: en/user_customization-packages.ssi:125
-#: en/user_customization-packages.ssi:139
-#: en/user_customization-packages.ssi:149
-#: en/user_customization-packages.ssi:159
-#: en/user_customization-packages.ssi:169
+#: en/user_customization-contents.ssi:70 en/user_customization-packages.ssi:18
+#: en/user_customization-packages.ssi:26 en/user_customization-packages.ssi:45
+#: en/user_customization-packages.ssi:58 en/user_customization-packages.ssi:70
+#: en/user_customization-packages.ssi:84 en/user_customization-packages.ssi:98
+#: en/user_customization-packages.ssi:116
+#: en/user_customization-packages.ssi:147
+#: en/user_customization-packages.ssi:161
+#: en/user_customization-packages.ssi:171
#: en/user_customization-packages.ssi:181
-#: en/user_customization-packages.ssi:197
-#: en/user_customization-packages.ssi:265
-#: en/user_customization-packages.ssi:277
-#: en/user_customization-packages.ssi:287 en/user_examples.ssi:20
-#: en/user_examples.ssi:34 en/user_examples.ssi:44 en/user_examples.ssi:58
-#: en/user_examples.ssi:68 en/user_examples.ssi:86 en/user_examples.ssi:101
-#: en/user_examples.ssi:111 en/user_examples.ssi:123 en/user_examples.ssi:135
-#: en/user_examples.ssi:150 en/user_examples.ssi:158 en/user_examples.ssi:166
-#: en/user_examples.ssi:197 en/user_examples.ssi:213 en/user_examples.ssi:221
+#: en/user_customization-packages.ssi:191
+#: en/user_customization-packages.ssi:203
+#: en/user_customization-packages.ssi:219
+#: en/user_customization-packages.ssi:294
+#: en/user_customization-packages.ssi:306
+#: en/user_customization-packages.ssi:316
+#: en/user_customization-packages.ssi:343 en/user_customization-runtime.ssi:18
+#: en/user_customization-runtime.ssi:36 en/user_customization-runtime.ssi:46
+#: en/user_customization-runtime.ssi:54 en/user_customization-runtime.ssi:62
+#: en/user_customization-runtime.ssi:70 en/user_customization-runtime.ssi:90
+#: en/user_customization-runtime.ssi:99 en/user_customization-runtime.ssi:108
+#: en/user_examples.ssi:20 en/user_examples.ssi:34 en/user_examples.ssi:44
+#: en/user_examples.ssi:58 en/user_examples.ssi:68 en/user_examples.ssi:86
+#: en/user_examples.ssi:101 en/user_examples.ssi:111 en/user_examples.ssi:123
+#: en/user_examples.ssi:135 en/user_examples.ssi:150 en/user_examples.ssi:158
+#: en/user_examples.ssi:166 en/user_examples.ssi:197 en/user_examples.ssi:213
+#: en/user_examples.ssi:221 en/user_examples.ssi:239 en/user_examples.ssi:252
+#: en/user_examples.ssi:267 en/user_examples.ssi:285
#: 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_installation.ssi:60 en/user_installation.ssi:70
+#: en/user_installation.ssi:78 en/user_installation.ssi:86
+#: en/user_installation.ssi:94 en/user_installation.ssi:118
+#: en/user_installation.ssi:137 en/user_installation.ssi:150
+#: 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_managing_a_configuration.ssi:52
+#: en/user_managing_a_configuration.ssi:60 en/user_overview.ssi:74
#: en/user_overview.ssi:84 en/user_overview.ssi:92
msgid "}code"
msgstr ""
@@ -222,7 +219,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:24
#, no-wrap
-msgid "*{Use case:}* Create a simple first image, learning the basics of live-build\n"
+msgid "*{Use case:}* Create a simple first image, learning the basics of live-build.\n"
msgstr ""
#. type: Plain text
@@ -283,7 +280,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:50
#, no-wrap
-msgid "*{Use case}* Create a web browser utility image, learning how to apply customizations\n"
+msgid "*{Use case:}* Create a web browser utility image, learning how to apply customizations.\n"
msgstr ""
#. type: Plain text
@@ -334,7 +331,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:74
#, 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"
+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
@@ -499,7 +496,8 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:174
-msgid "Create an image with live-build to boot directly to a VNC server."
+#, no-wrap
+msgid "*{Use case:}* Create an image with live-build to boot directly to a VNC server.\n"
msgstr ""
#. type: Plain text
@@ -568,7 +566,7 @@ msgstr ""
#. type: Plain text
#: en/user_examples.ssi:205
#, 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"
+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
@@ -622,3 +620,116 @@ msgid ""
"you to decide if the functionality that is sacrificed with each optimization "
"is worth the loss in functionality."
msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:227
+msgid "2~ A localized KDE desktop and installer"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:229
+#, no-wrap
+msgid "*{Use case:}* Create a KDE desktop image, localized for Brazilian Portuguese and including an installer.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:231
+msgid ""
+"We want to make an iso-hybrid image for i386 architecture using our "
+"preferred desktop, in this case KDE, containing all of the same packages "
+"that would be installed by the standard Debian installer for KDE."
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:233
+msgid ""
+"Our initial problem is the discovery of the names of the appropriate tasks. "
+"Currently, live-build cannot help with this. While we might get lucky and "
+"find this by trial-and-error, there is a tool, #{grep-dctrl}#, which can be "
+"used to dig it out of the task descriptions in tasksel-data, so to prepare, "
+"make sure you have both of those things:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:237
+msgid "# apt-get install dctrl-tools tasksel-data"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:241
+msgid "Now we can search for the appropriate tasks, first with:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:250
+#, no-wrap
+msgid ""
+"$ grep-dctrl -FTest-lang pt_BR /usr/share/tasksel/debian-tasks.desc -sTask,Description\n"
+"Task: brazilian-portuguese\n"
+"Description: Brazilian Portuguese environment\n"
+" This task installs programs, data files, and\n"
+" documentation that make it easier for Brazilian Portuguese speakers\n"
+" to use Debian.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:254
+msgid ""
+"By this command, we discover the task is called, plainly enough, brazilian-"
+"portuguese. Now to find the related tasks:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:261
+#, no-wrap
+msgid ""
+"$ grep-dctrl -FEnhances brazilian-portuguese /usr/share/tasksel/debian-tasks.desc -sTask,Description\n"
+"Task: brazilian-portuguese-desktop\n"
+"Description: Brazilian Portuguese desktop\n"
+" This task localises the desktop in Brasilian Portuguese.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:265
+#, no-wrap
+msgid ""
+"Task: brazilian-portuguese-kde-desktop\n"
+"Description: Brazilian Portuguese KDE desktop\n"
+" This task localises the KDE desktop in Brazilian Portuguese.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:269
+msgid ""
+"We will use the experimental #{--language}# option, as live-build happens to "
+"include #{syslinux}# templates for pt_BR (see {Desktop and language tasks}"
+"#destkop-and-language-tasks for details). And at boot time we will generate "
+"the pt_BR.UTF-8 locale and select the pt-latin1 keyboard layout. Now let's "
+"put the pieces together:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:283
+#, no-wrap
+msgid ""
+"$ mkdir live-pt_BR-kde\n"
+"$ cd live-pt_BR-kde\n"
+"$ lb config \\\n"
+" -a i386 \\\n"
+" -k 486 \\\n"
+" -p kde-desktop \\\n"
+" --language pt_BR \\\n"
+" --tasks \"brazilian-portuguese brazilian-portuguese-desktop brazilian-portuguese-kde-desktop\" \\\n"
+" --bootappend-live \"locales=pt_BR.UTF-8 keyboard-layouts=pt-latin1\"\n"
+" --debian-installer live \\\n"
+" --packages debian-installer-launcher\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_examples.ssi:287
+msgid ""
+"Note that we have included the #{debian-installer-launcher}# package to "
+"launch the installer from the live desktop, and have also specified the 486 "
+"flavour kernel, as it is currently necessary to make the installer and live "
+"system kernels match for the launcher to work properly."
+msgstr ""
diff --git a/manual/pt_BR/user_examples.ssi b/manual/pt_BR/user_examples.ssi
index 0bb4753..d3f44f8 100644
--- a/manual/pt_BR/user_examples.ssi
+++ b/manual/pt_BR/user_examples.ssi
@@ -32,7 +32,7 @@ LB_MIRROR_CHROOT_SECURITY="http://mirror/debian-security"
2~tutorial-1 Tutorial 1: A standard image
-*{Use case:}* Create a simple first image, learning the basics of live-build
+*{Use case:}* Create a simple first image, learning the basics of live-build.
In this tutorial, we will build a default ISO hybrid Debian Live image
containing only base packages (no Xorg) and some Debian Live support
@@ -69,7 +69,7 @@ stick}#copying-usb-hdd-image, respectively.
2~tutorial-2 Tutorial 2: A web browser utility
-*{Use case}* Create a web browser utility image, learning how to apply customizations
+*{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, serving as an introduction to customizing Debian Live images.
@@ -101,7 +101,7 @@ Again, verify the image is OK and test, as in {Tutorial 1}#tutorial-1.
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.
+*{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.
Since we will be changing our personalized image over a number of revisions,
and we want to track those changes, trying things experimentally and
@@ -224,7 +224,7 @@ cases drawn from the collected experiences of users of Debian Live.
2~ A VNC Kiosk Client
-Create an image with live-build to boot directly to a VNC server.
+*{Use case:}* Create an image with live-build to boot directly to a VNC server.
_* Make a build directory: #{$ mkdir vncBuild}#
@@ -258,7 +258,7 @@ _* Enjoy.
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.
+*{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
@@ -303,3 +303,79 @@ 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.
+2~ A localized KDE desktop and installer
+
+*{Use case:}* Create a KDE desktop image, localized for Brazilian Portuguese and including an installer.
+
+We want to make an iso-hybrid image for i386 architecture using our
+preferred desktop, in this case KDE, containing all of the same packages
+that would be installed by the standard Debian installer for KDE.
+
+Our initial problem is the discovery of the names of the appropriate
+tasks. Currently, live-build cannot help with this. While we might get lucky
+and find this by trial-and-error, there is a tool, #{grep-dctrl}#, which can
+be used to dig it out of the task descriptions in tasksel-data, so to
+prepare, make sure you have both of those things:
+
+code{
+
+# apt-get install dctrl-tools tasksel-data
+
+}code
+
+Now we can search for the appropriate tasks, first with:
+
+code{
+
+$ grep-dctrl -FTest-lang pt_BR /usr/share/tasksel/debian-tasks.desc -sTask,Description
+Task: brazilian-portuguese
+Description: Brazilian Portuguese environment
+ This task installs programs, data files, and
+ documentation that make it easier for Brazilian Portuguese speakers
+ to use Debian.
+
+}code
+
+By this command, we discover the task is called, plainly enough,
+brazilian-portuguese. Now to find the related tasks:
+
+code{
+
+$ grep-dctrl -FEnhances brazilian-portuguese /usr/share/tasksel/debian-tasks.desc -sTask,Description
+Task: brazilian-portuguese-desktop
+Description: Brazilian Portuguese desktop
+ This task localises the desktop in Brasilian Portuguese.
+
+Task: brazilian-portuguese-kde-desktop
+Description: Brazilian Portuguese KDE desktop
+ This task localises the KDE desktop in Brazilian Portuguese.
+
+}code
+
+We will use the experimental #{--language}# option, as live-build happens to
+include #{syslinux}# templates for pt_BR (see {Desktop and language
+tasks}#destkop-and-language-tasks for details). And at boot time we will
+generate the pt_BR.UTF-8 locale and select the pt-latin1 keyboard
+layout. Now let's put the pieces together:
+
+code{
+
+$ mkdir live-pt_BR-kde
+$ cd live-pt_BR-kde
+$ lb config \
+ -a i386 \
+ -k 486 \
+ -p kde-desktop \
+ --language pt_BR \
+ --tasks "brazilian-portuguese brazilian-portuguese-desktop brazilian-portuguese-kde-desktop" \
+ --bootappend-live "locales=pt_BR.UTF-8 keyboard-layouts=pt-latin1"
+ --debian-installer live \
+ --packages debian-installer-launcher
+
+}code
+
+Note that we have included the #{debian-installer-launcher}# package to
+launch the installer from the live desktop, and have also specified the 486
+flavour kernel, as it is currently necessary to make the installer and live
+system kernels match for the launcher to work properly.
+
diff --git a/manual/ro/user_examples.ssi b/manual/ro/user_examples.ssi
index 0bb4753..d3f44f8 100644
--- a/manual/ro/user_examples.ssi
+++ b/manual/ro/user_examples.ssi
@@ -32,7 +32,7 @@ LB_MIRROR_CHROOT_SECURITY="http://mirror/debian-security"
2~tutorial-1 Tutorial 1: A standard image
-*{Use case:}* Create a simple first image, learning the basics of live-build
+*{Use case:}* Create a simple first image, learning the basics of live-build.
In this tutorial, we will build a default ISO hybrid Debian Live image
containing only base packages (no Xorg) and some Debian Live support
@@ -69,7 +69,7 @@ stick}#copying-usb-hdd-image, respectively.
2~tutorial-2 Tutorial 2: A web browser utility
-*{Use case}* Create a web browser utility image, learning how to apply customizations
+*{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, serving as an introduction to customizing Debian Live images.
@@ -101,7 +101,7 @@ Again, verify the image is OK and test, as in {Tutorial 1}#tutorial-1.
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.
+*{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.
Since we will be changing our personalized image over a number of revisions,
and we want to track those changes, trying things experimentally and
@@ -224,7 +224,7 @@ cases drawn from the collected experiences of users of Debian Live.
2~ A VNC Kiosk Client
-Create an image with live-build to boot directly to a VNC server.
+*{Use case:}* Create an image with live-build to boot directly to a VNC server.
_* Make a build directory: #{$ mkdir vncBuild}#
@@ -258,7 +258,7 @@ _* Enjoy.
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.
+*{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
@@ -303,3 +303,79 @@ 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.
+2~ A localized KDE desktop and installer
+
+*{Use case:}* Create a KDE desktop image, localized for Brazilian Portuguese and including an installer.
+
+We want to make an iso-hybrid image for i386 architecture using our
+preferred desktop, in this case KDE, containing all of the same packages
+that would be installed by the standard Debian installer for KDE.
+
+Our initial problem is the discovery of the names of the appropriate
+tasks. Currently, live-build cannot help with this. While we might get lucky
+and find this by trial-and-error, there is a tool, #{grep-dctrl}#, which can
+be used to dig it out of the task descriptions in tasksel-data, so to
+prepare, make sure you have both of those things:
+
+code{
+
+# apt-get install dctrl-tools tasksel-data
+
+}code
+
+Now we can search for the appropriate tasks, first with:
+
+code{
+
+$ grep-dctrl -FTest-lang pt_BR /usr/share/tasksel/debian-tasks.desc -sTask,Description
+Task: brazilian-portuguese
+Description: Brazilian Portuguese environment
+ This task installs programs, data files, and
+ documentation that make it easier for Brazilian Portuguese speakers
+ to use Debian.
+
+}code
+
+By this command, we discover the task is called, plainly enough,
+brazilian-portuguese. Now to find the related tasks:
+
+code{
+
+$ grep-dctrl -FEnhances brazilian-portuguese /usr/share/tasksel/debian-tasks.desc -sTask,Description
+Task: brazilian-portuguese-desktop
+Description: Brazilian Portuguese desktop
+ This task localises the desktop in Brasilian Portuguese.
+
+Task: brazilian-portuguese-kde-desktop
+Description: Brazilian Portuguese KDE desktop
+ This task localises the KDE desktop in Brazilian Portuguese.
+
+}code
+
+We will use the experimental #{--language}# option, as live-build happens to
+include #{syslinux}# templates for pt_BR (see {Desktop and language
+tasks}#destkop-and-language-tasks for details). And at boot time we will
+generate the pt_BR.UTF-8 locale and select the pt-latin1 keyboard
+layout. Now let's put the pieces together:
+
+code{
+
+$ mkdir live-pt_BR-kde
+$ cd live-pt_BR-kde
+$ lb config \
+ -a i386 \
+ -k 486 \
+ -p kde-desktop \
+ --language pt_BR \
+ --tasks "brazilian-portuguese brazilian-portuguese-desktop brazilian-portuguese-kde-desktop" \
+ --bootappend-live "locales=pt_BR.UTF-8 keyboard-layouts=pt-latin1"
+ --debian-installer live \
+ --packages debian-installer-launcher
+
+}code
+
+Note that we have included the #{debian-installer-launcher}# package to
+launch the installer from the live desktop, and have also specified the 486
+flavour kernel, as it is currently necessary to make the installer and live
+system kernels match for the launcher to work properly.
+
--
live-manual
More information about the debian-live-changes
mailing list