aboutsummaryrefslogtreecommitdiffhomepage
path: root/markup/pod/live-manual/media/text/de/user_customization-binary.ssi
diff options
context:
space:
mode:
authorRalph Amissah <ralph.amissah@gmail.com>2021-11-27 21:54:49 -0500
committerRalph Amissah <ralph.amissah@gmail.com>2021-11-27 21:54:49 -0500
commit78b1b83be0cf04b4cba707751b7ad4d97787fe37 (patch)
tree0260daae62c3c0c055b7ec73b274fa82b31b344f /markup/pod/live-manual/media/text/de/user_customization-binary.ssi
track document samples used
Diffstat (limited to 'markup/pod/live-manual/media/text/de/user_customization-binary.ssi')
-rw-r--r--markup/pod/live-manual/media/text/de/user_customization-binary.ssi62
1 files changed, 62 insertions, 0 deletions
diff --git a/markup/pod/live-manual/media/text/de/user_customization-binary.ssi b/markup/pod/live-manual/media/text/de/user_customization-binary.ssi
new file mode 100644
index 0000000..aa7929a
--- /dev/null
+++ b/markup/pod/live-manual/media/text/de/user_customization-binary.ssi
@@ -0,0 +1,62 @@
+:B~ Customizing the binary image
+
+1~customizing-binary Customizing the binary image
+
+2~ Bootloaders
+
+live-build uses /{syslinux}/ and some of its derivatives (depending on the
+image type) as bootloaders by default. They can be easily customized to suit
+your needs.
+
+In order to use a full theme, copy #{/usr/share/live/build/bootloaders}#
+into #{config/bootloaders}# and edit the files in there. If you do not want
+to bother modifying all supported bootloader configurations, only providing
+a local customized copy of one of the bootloaders, e.g. *{isolinux}* in
+#{config/bootloaders/isolinux}# is enough too, depending on your use case.
+
+When modifying one of the default themes, if you want to use a personalized
+background image that will be displayed together with the boot menu, add a
+splash.png picture of 640x480 pixels. Then, remove the splash.svg file.
+
+There are many possibilities when it comes to making changes. For instance,
+syslinux derivatives are configured by default with a timeout of 0 (zero)
+which means that they will pause indefinitely at their splash screen until
+you press a key.
+
+To modify the boot timeout of a default #{iso-hybrid}# image just edit a
+default *{isolinux.cfg}* file specifying the timeout in units of 1/10
+seconds. A modified *{isolinux.cfg}* to boot after five seconds would be
+similar to this:
+
+code{
+
+ include menu.cfg
+ default vesamenu.c32
+ prompt 0
+ timeout 50
+
+}code
+
+2~ ISO metadata
+
+When creating an ISO9660 binary image, you can use the following options to
+add various textual metadata for your image. This can help you easily
+identify the version or configuration of an image without booting it.
+
+_* #{LB_ISO_APPLICATION/--iso-application NAME}#: This should describe the
+application that will be on the image. The maximum length for this field is
+128 characters.
+
+_* #{LB_ISO_PREPARER/--iso-preparer NAME}#: This should describe the
+preparer of the image, usually with some contact details. The default for
+this option is the live-build version you are using, which may help with
+debugging later. The maximum length for this field is 128 characters.
+
+_* #{LB_ISO_PUBLISHER/--iso-publisher NAME}#: This should describe the
+publisher of the image, usually with some contact details. The maximum
+length for this field is 128 characters.
+
+_* #{LB_ISO_VOLUME/--iso-volume NAME}#: This should specify the volume ID of
+the image. This is used as a user-visible label on some platforms such as
+Windows and Apple Mac OS. The maximum length for this field is 32
+characters.