# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the live-manual package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: live-manual VERSION\n" "POT-Creation-Date: 2010-12-19 20:37-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=CHARSET\n" "Content-Transfer-Encoding: 8bit\n" #. type: Plain text #: en/live-manual.ssm:61 en/user_examples.ssi:2 msgid ":B~ Examples" msgstr "" #. type: Plain text #: 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/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:30 en/user_basics.ssi:40 #: en/user_basics.ssi:52 en/user_basics.ssi:64 en/user_basics.ssi:76 #: en/user_basics.ssi:86 en/user_basics.ssi:100 en/user_basics.ssi:108 #: en/user_basics.ssi:116 en/user_basics.ssi:126 en/user_basics.ssi:140 #: en/user_basics.ssi:152 en/user_basics.ssi:160 en/user_basics.ssi:168 #: en/user_basics.ssi:182 en/user_basics.ssi:190 en/user_basics.ssi:200 #: en/user_basics.ssi:218 en/user_basics.ssi:246 en/user_basics.ssi:262 #: en/user_basics.ssi:270 en/user_basics.ssi:290 en/user_basics.ssi:315 #: en/user_customization-contents.ssi:26 en/user_customization-contents.ssi:35 #: en/user_customization-contents.ssi:54 en/user_customization-contents.ssi:66 #: en/user_customization-installer.ssi:32 #: en/user_customization-installer.ssi:43 #: 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:291 #: en/user_customization-packages.ssi:303 #: en/user_customization-packages.ssi:313 #: en/user_customization-packages.ssi:331 #: en/user_customization-packages.ssi:348 en/user_customization-runtime.ssi:14 #: en/user_customization-runtime.ssi:32 en/user_customization-runtime.ssi:42 #: en/user_customization-runtime.ssi:51 en/user_customization-runtime.ssi:59 #: en/user_customization-runtime.ssi:68 en/user_customization-runtime.ssi:89 #: en/user_customization-runtime.ssi:97 en/user_customization-runtime.ssi:106 #: 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:178 en/user_examples.ssi:190 #: en/user_examples.ssi:206 en/user_examples.ssi:220 en/user_examples.ssi:229 #: en/user_examples.ssi:247 en/user_examples.ssi:255 en/user_examples.ssi:268 #: en/user_examples.ssi:283 en/user_installation.ssi:38 #: en/user_installation.ssi:46 en/user_installation.ssi:56 #: en/user_installation.ssi:64 en/user_installation.ssi:74 #: en/user_installation.ssi:82 en/user_installation.ssi:90 #: en/user_installation.ssi:114 en/user_installation.ssi:129 #: en/user_installation.ssi:146 en/user_managing_a_configuration.ssi:24 #: en/user_managing_a_configuration.ssi:35 #: 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 "" #. type: Plain text #: 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:174 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:34 en/user_basics.ssi:44 #: en/user_basics.ssi:58 en/user_basics.ssi:70 en/user_basics.ssi:80 #: en/user_basics.ssi:92 en/user_basics.ssi:104 en/user_basics.ssi:112 #: en/user_basics.ssi:120 en/user_basics.ssi:130 en/user_basics.ssi:146 #: en/user_basics.ssi:156 en/user_basics.ssi:164 en/user_basics.ssi:172 #: en/user_basics.ssi:186 en/user_basics.ssi:194 en/user_basics.ssi:204 #: en/user_basics.ssi:238 en/user_basics.ssi:250 en/user_basics.ssi:266 #: en/user_basics.ssi:274 en/user_basics.ssi:301 en/user_basics.ssi:340 #: en/user_customization-contents.ssi:31 en/user_customization-contents.ssi:46 #: en/user_customization-contents.ssi:58 en/user_customization-contents.ssi:70 #: en/user_customization-installer.ssi:37 #: en/user_customization-installer.ssi:48 #: 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:191 #: en/user_customization-packages.ssi:203 #: en/user_customization-packages.ssi:219 #: en/user_customization-packages.ssi:231 #: en/user_customization-packages.ssi:295 #: en/user_customization-packages.ssi:307 #: en/user_customization-packages.ssi:317 #: en/user_customization-packages.ssi:344 #: en/user_customization-packages.ssi:354 en/user_customization-runtime.ssi:18 #: en/user_customization-runtime.ssi:36 en/user_customization-runtime.ssi:47 #: en/user_customization-runtime.ssi:55 en/user_customization-runtime.ssi:64 #: en/user_customization-runtime.ssi:73 en/user_customization-runtime.ssi:93 #: en/user_customization-runtime.ssi:102 en/user_customization-runtime.ssi:111 #: 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:186 en/user_examples.ssi:202 #: en/user_examples.ssi:210 en/user_examples.ssi:225 en/user_examples.ssi:233 #: en/user_examples.ssi:251 en/user_examples.ssi:264 en/user_examples.ssi:279 #: en/user_examples.ssi:297 en/user_installation.ssi:42 #: en/user_installation.ssi:50 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:119 en/user_installation.ssi:136 #: 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_managing_a_configuration.ssi:60 en/user_overview.ssi:74 #: en/user_overview.ssi:84 en/user_overview.ssi:92 msgid "}code" msgstr "" #. type: Plain text #: en/user_basics.ssi:42 en/user_basics.ssi:118 en/user_basics.ssi:202 #: en/user_examples.ssi:109 en/user_examples.ssi:208 #, no-wrap msgid " # lb build\n" msgstr "" #. type: Plain text #: en/user_examples.ssi:4 msgid "1~examples Examples" msgstr "" #. type: Plain text #: en/user_examples.ssi:6 msgid "" "This chapter covers example builds for specific use cases with Debian Live. " "If you are new to building your own Debian Live images, we recommend you " "first look at the three tutorials in sequence, as each one teaches new " "techniques that will help you use and understand the remaining examples." msgstr "" #. type: Plain text #: en/user_examples.ssi:8 msgid "2~using-the-examples Using the examples" msgstr "" #. type: Plain text #: en/user_examples.ssi:10 msgid "" "To use these examples you need a system to build them on that meets the " "requirements listed in {Requirements}#requirements and has live-build " "installed as described in {Installing live-build}#installing-live-build." msgstr "" #. type: Plain text #: en/user_examples.ssi:12 msgid "" "Note that, for the sake of brevity, in these examples we do not specify a " "local mirror to use for the build. You can speed up downloads considerably " "if you use a local mirror. You may specify the options when you use #{lb " "config}#, as described in {Distribution mirrors used at build time}" "#distribution-mirrors-build-time, or for more convenience, set the default " "for your build system in #{/etc/live/build.conf}#. Simply create this file " "and in it, set the corresponding #{LB_MIRROR_*}# variables to your preferred " "mirror. For example:" msgstr "" #. type: Plain text #: en/user_examples.ssi:18 #, no-wrap msgid "" " LB_MIRROR_BOOTSTRAP=\"http://mirror/debian\"\n" " LB_MIRROR_CHROOT=\"http://mirror/debian\"\n" " LB_MIRROR_CHROOT_SECURITY=\"http://mirror/debian-security\"\n" msgstr "" #. type: Plain text #: en/user_examples.ssi:22 msgid "2~tutorial-1 Tutorial 1: A standard image" 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" msgstr "" #. type: Plain text #: en/user_examples.ssi:26 msgid "" "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." msgstr "" #. type: Plain text #: en/user_examples.ssi:28 msgid "You can't get much simpler than this:" msgstr "" #. type: Plain text #: en/user_examples.ssi:32 #, no-wrap msgid " $ mkdir tutorial1 ; cd tutorial1 ; lb config\n" msgstr "" #. type: Plain text #: en/user_examples.ssi:36 msgid "" "Examine the contents of the #{config/}# directory if you wish. You will see " "stored here a skeletal configuration, ready to customize or, in this case, " "use immediately to build a default image." msgstr "" #. type: Plain text #: en/user_examples.ssi:38 msgid "" "Now, as superuser, build the image, saving a log as you build with #{tee}#." msgstr "" #. type: Plain text #: en/user_examples.ssi:42 en/user_examples.ssi:66 en/user_examples.ssi:231 #, no-wrap msgid " # lb build 2>&1 | tee binary.log\n" msgstr "" #. type: Plain text #: en/user_examples.ssi:46 msgid "" "Assuming all goes well, after a while, the current directory will contain #" "{binary-hybrid.iso}#. This ISO hybrid image can be booted directly in a " "virtual machine as described in {Testing an ISO image with Qemu}#testing-iso-" "with-qemu and {Testing an ISO image with virtualbox-ose}#testing-iso-with-" "virtualbox, or else imaged onto optical media or a USB flash device as " "described in {Burning an ISO image to a physical medium}#burning-iso-image " "and {Copying USB/HDD image to a USB stick}#copying-usb-hdd-image, " "respectively." msgstr "" #. type: Plain text #: en/user_examples.ssi:48 msgid "2~tutorial-2 Tutorial 2: A web browser utility" 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" msgstr "" #. type: Plain text #: en/user_examples.ssi:52 msgid "" "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." msgstr "" #. type: Plain text #: en/user_examples.ssi:56 #, no-wrap msgid " $ mkdir tutorial2 ; cd tutorial2 ; lb config -p lxde --packages iceweasel\n" msgstr "" #. type: Plain text #: en/user_examples.ssi:60 msgid "" "Our choice of LXDE for this example reflects our desire to provide a minimal " "desktop environment, since the focus of the image is the single use we have " "in mind, the web browser. We could go even further and provide a default " "configuration for the web browser in #{config/chroot_local-includes/etc/" "iceweasel/profile/}#, or additional support packages for viewing various " "kinds of web content, but we leave this as an exercise for the reader." msgstr "" #. type: Plain text #: en/user_examples.ssi:62 msgid "" "Build the image, again as superuser, keeping a log as in {Tutorial 1}" "#tutorial-1:" msgstr "" #. type: Plain text #: en/user_examples.ssi:70 msgid "Again, verify the image is OK and test, as in {Tutorial 1}#tutorial-1." msgstr "" #. type: Plain text #: en/user_examples.ssi:72 msgid "2~tutorial-3 Tutorial 3: A personalized image" 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" msgstr "" #. type: Plain text #: en/user_examples.ssi:76 msgid "" "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." msgstr "" #. type: Plain text #: en/user_examples.ssi:78 msgid "3~ First revision" msgstr "" #. type: Plain text #: en/user_examples.ssi:84 #, no-wrap msgid "" " $ mkdir -p tutorial3/auto\n" " $ cp /usr/share/live/build/examples/auto/* tutorial3/auto/\n" " $ cd tutorial3\n" msgstr "" #. type: Plain text #: en/user_examples.ssi:88 msgid "Edit #{auto/config}# to read as follows:" msgstr "" #. type: Plain text #: en/user_examples.ssi:92 en/user_examples.ssi:141 #, no-wrap msgid " #!/bin/sh\n" msgstr "" #. type: Plain text #: en/user_examples.ssi:99 #, no-wrap msgid "" " lb config noauto \\\n" " --architecture i386 \\\n" " --linux-flavours 686 \\\n" " --packages-lists lxde \\\n" " --packages \"iceweasel xchat\" \\\n" " \"${@}\"\n" msgstr "" #. type: Plain text #: en/user_examples.ssi:103 msgid "" "First, #{--architecture i386}# ensures that on our #{amd64}# build system, " "we build a 32-bit version suitable for use on most machines. Second, we use #" "{--linux-flavours 686}# because we don't anticipate using this image on much " "older systems. Third, we've chosen the #{lxde}# package list to give us a " "minimal desktop. And finally, we have added two initial favourite packages: #" "{iceweasel}# and #{xchat}#." msgstr "" #. type: Plain text #: en/user_examples.ssi:105 msgid "Now, build the image:" msgstr "" #. type: Plain text #: en/user_examples.ssi:113 msgid "" "Note that unlike in the first two tutorials, we no longer have to type #" "{2>&1 | tee binary.log}# as that is now included in #{auto/build}#." msgstr "" #. type: Plain text #: en/user_examples.ssi:115 msgid "" "Once you've tested the image (as in {Tutorial 1}#tutorial-1) and are " "satisfied it works, it's time to initialize our #{git}# repository, adding " "only the auto scripts we just created, and then make the first commit:" msgstr "" #. type: Plain text #: en/user_examples.ssi:121 #, no-wrap msgid "" " $ git init\n" " $ git add auto\n" " $ git commit -a -m \"Initial import.\"\n" msgstr "" #. type: Plain text #: en/user_examples.ssi:125 msgid "3~ Second revision" msgstr "" #. type: Plain text #: en/user_examples.ssi:127 msgid "" "In this revision, we're going to clean up from the first build, add the #" "{vlc}# package to our configuration, rebuild, test and commit." msgstr "" #. type: Plain text #: en/user_examples.ssi:129 msgid "" "The #{lb clean}# command will clean up all generated files from the previous " "build except for the cache, which saves having to re-download packages. This " "ensures that the subsequent #{lb build}# will re-run all stages to " "regenerate the files from our new configuration." msgstr "" #. type: Plain text #: en/user_examples.ssi:133 #, no-wrap msgid " # lb clean\n" msgstr "" #. type: Plain text #: en/user_examples.ssi:137 msgid "Now edit #{auto/config}# to add the #{vlc}# package:" msgstr "" #. type: Plain text #: en/user_examples.ssi:148 #, no-wrap msgid "" " lb config noauto \\\n" " --architecture i386 \\\n" " --linux-flavours 686 \\\n" " --packages-lists lxde \\\n" " --packages \"iceweasel xchat vlc\" \\\n" " \"${@}\"\n" msgstr "" #. type: Plain text #: en/user_examples.ssi:152 msgid "Build again:" msgstr "" #. type: Plain text #: en/user_examples.ssi:156 msgid "# lb build" msgstr "" #. type: Plain text #: en/user_examples.ssi:160 msgid "Test, and when you're satisfied, commit the next revision:" msgstr "" #. type: Plain text #: en/user_examples.ssi:164 #, no-wrap msgid " $ git commit -a -m \"Adding vlc media player.\"\n" msgstr "" #. type: Plain text #: en/user_examples.ssi:168 msgid "" "Of course, more complicated changes to the configuration are possible, " "perhaps adding files in subdirectories of #{config/}#. When you commit new " "revisions, just take care not to hand edit or commit the top-level files in #" "{config}# containing #{LB_*}# variables, as these are build products, too, " "and are always cleaned up by #{lb clean}# and re-created with #{lb config}# " "via their respective #{auto}# scripts." msgstr "" #. type: Plain text #: en/user_examples.ssi:170 msgid "" "We've come to the end of our tutorial series. While many more kinds of " "customization are possible, even just using the few features explored in " "these simple examples, an almost infinite variety of different images can be " "created. The remaining examples in this section cover several other use " "cases drawn from the collected experiences of users of Debian Live." msgstr "" #. type: Plain text #: en/user_examples.ssi:172 msgid "2~ A VNC Kiosk Client" msgstr "" #. type: Plain text #: en/user_examples.ssi:174 #, no-wrap msgid "*{Use case:}* Create an image with live-build to boot directly to a VNC server.\n" msgstr "" #. type: Plain text #: en/user_examples.ssi:176 msgid "" "Make a build directory and create a skeletal configuration in it built " "around the standard-x11 list, including #{gdm3}#, #{metacity}# and #" "{xtightvncviewer}#, disabling recommends to make a minimal system:" msgstr "" #. type: Plain text #: en/user_examples.ssi:184 #, no-wrap msgid "" " $ mkdir vnc_kiosk_client\n" " $ cd vnc_kiosk_client\n" " $ lb config -a i386 -k 686 -p standard-x11 \\\n" " --packages \"gdm3 metacity xvnc4viewer\" \\\n" " --apt-recommends false\n" msgstr "" #. type: Plain text #: en/user_examples.ssi:188 msgid "" "Create the directory #{/etc/skel}# and put a custom #{.xsession}# in it for " "the default user that will launch metacity and start xvncviewer, connecting " "to port #{5901}# on a server at #{192.168.1.2}#:" msgstr "" #. type: Plain text #: en/user_examples.ssi:194 #, no-wrap msgid "" " $ mkdir -p config/chroot_local-includes/etc/skel\n" " $ cat >config/chroot_local-includes/etc/skel/.xsession <