From 366ffd424aeec00df9fb4fb9efdcee9641dacbec Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcus=20Sch=C3=A4fer?= Date: Tue, 16 May 2017 09:47:52 +0200 Subject: [PATCH] Restructure low level topic (iso_to_usb) The low level topic references information from the base topic. In this case the name of the previously built image. I think we should provide information on each low level topic which references information from a base topic. --- doc/source/building/build_live_iso.rst | 14 +++++--------- doc/source/building/working_with_images.rst | 2 +- .../iso_to_usb_stick_deployment.rst} | 19 +++++++++++++++++-- 3 files changed, 23 insertions(+), 12 deletions(-) rename doc/source/building/{dump_to_usb-stick.rst => working_with_images/iso_to_usb_stick_deployment.rst} (56%) diff --git a/doc/source/building/build_live_iso.rst b/doc/source/building/build_live_iso.rst index 66dd2050..bcc661cd 100644 --- a/doc/source/building/build_live_iso.rst +++ b/doc/source/building/build_live_iso.rst @@ -9,15 +9,11 @@ Build an ISO Hybrid Live Image * how to build an ISO image * how to run it with QEMU - * how to dump the resulting ISO image on an USB stick -In KIWI all generated ISO images are created to be hybrid. This means, -the image can be used as a CD/DVD or as a disk. This works because -the ISO image also has a partition table embedded. With more and more -computers delivered without a CD/DVD drive this becomes important. - -The very same ISO image can be copied onto a USB stick and used as a -bootable disk. +A Live ISO image is a system on a removable media, e.g CD/DVD or USB stick. +Once built and deployed it boots off from this media without interferring +with other system storage components. A useful pocket system for testing +and demo and debugging purposes. The following example shows how to build a live ISO image based on openSUSE Leap: @@ -42,4 +38,4 @@ openSUSE Leap: $ qemu -cdrom LimeJeOS-Leap-42.1.x86_64-1.42.1.iso -m 4096 After the test was successful, the image is complete and ready to use. -See :ref:`dump_usb_stick` for further information. +See :ref:`iso_to_usb_stick` for further information. diff --git a/doc/source/building/working_with_images.rst b/doc/source/building/working_with_images.rst index c01a2cbc..9f62efb7 100644 --- a/doc/source/building/working_with_images.rst +++ b/doc/source/building/working_with_images.rst @@ -6,4 +6,4 @@ different image types. .. toctree:: - dump_to_usb-stick + working_with_images/iso_to_usb_stick_deployment diff --git a/doc/source/building/dump_to_usb-stick.rst b/doc/source/building/working_with_images/iso_to_usb_stick_deployment.rst similarity index 56% rename from doc/source/building/dump_to_usb-stick.rst rename to doc/source/building/working_with_images/iso_to_usb_stick_deployment.rst index 34e062a1..6c86fa0d 100644 --- a/doc/source/building/dump_to_usb-stick.rst +++ b/doc/source/building/working_with_images/iso_to_usb_stick_deployment.rst @@ -1,8 +1,23 @@ -.. _dump_usb_stick: +.. _iso_to_usb_stick: -Dumping an Image to an USB Stick +Deploy ISO Image on an USB Stick ================================ +.. sidebar:: Abstract + + This page provides further information for handling + ISO images built with KIWI and references the following + articles: + + * :ref:`hybrid_iso` + +In KIWI all generated ISO images are created to be hybrid. This means, +the image can be used as a CD/DVD or as a disk. This works because +the ISO image also has a partition table embedded. With more and more +computers delivered without a CD/DVD drive this becomes important. + +The very same ISO image can be copied onto a USB stick and used as a +bootable disk. The following procedure shows how to do this: 1. Plug in a USB stick