From: <bms...@us...> - 2006-07-11 21:13:39
|
Revision: 2346 Author: bmsleight Date: 2006-07-11 14:13:32 -0700 (Tue, 11 Jul 2006) ViewCVS: http://svn.sourceforge.net/morphix/?rev=2346&view=rev Log Message: ----------- Manual - starting to write version 0.3 Modified Paths: -------------- trunk/how_tos/morphix_docbook.txt Modified: trunk/how_tos/morphix_docbook.txt =================================================================== --- trunk/how_tos/morphix_docbook.txt 2006-07-10 20:40:17 UTC (rev 2345) +++ trunk/how_tos/morphix_docbook.txt 2006-07-11 21:13:32 UTC (rev 2346) @@ -14,7 +14,7 @@ Morphix Manual ============== www Morphix Org -v0.2, February 2006 +v0.3, July 2006 :Author Initials: BMS Dedication @@ -104,7 +104,6 @@ around 500MB. Morphix KDE - ^^^^^^^^^^^ Although primarily focused on GTK/Gnome, the Morphix crew acknowledges that users might prefer KDE instead (and looking at the number of @@ -155,58 +154,6 @@ Happy Morphing! -Fast Introduction to building your own Morphix based livecd -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Really Fast Introduction -^^^^^^^^^^^^^^^^^^^^^^^^ - -* Get a Morphix Base iso -* Add "deb http://www.morphix.org/debian ./" to your /etc/apt/source.list -* apt-get update ; apt-get install morphing-tools -* Edit mymainmod.xml -* mmaker mymainmod.xml myprograms.mod -* make-iso /path/source myfirstlivecd.iso - -Fast Introduction -^^^^^^^^^^^^^^^^^ - -Foreplay -++++++++ - -* Use a Debian based Linux distro [preferably Debian sid, aka unstable, but every recent one should do] -* Get a morphix based .iso [or better: just a base .iso, preferably a stable one atm, like 0.5-pre5 or an autobuilded base .iso] -* Open a root terminal [su -, you get the point] -* mount -t iso9660 -o loop nameoftheisoyoudownloaded.iso /mnt/whatever -* cp -a /mnt/whatever/* /path/to/the/extracted/stuff [like /scratch/iso] - -Setting up the build environment -++++++++++++++++++++++++++++++++ - -* Add "deb http://www.morphix.org/debian ./" to your /etc/apt/source.list -* apt-get update -* apt-get install morphing-tools - -Creating your own mainmodule -++++++++++++++++++++++++++++++ - -* See this manual about mmaker for building an .xml file describing your mainmodule, which will basically be your system -* If you're done with the .xml file [e.g., mymainmod.xml], type "mmaker mymainmod.xml myprograms.mod" or whatever you like to name them - -Building an .iso out of it -++++++++++++++++++++++++++ - -* Now, remove the files in /scratch/iso/mainmod -* Copy/move your myprograms.mod into /scratch/iso/mainmod -* make-iso /scratch/iso myfirstlivecd.iso -* Done. Burn to cd with your favorite burn program or run with "qemu -cdrom myfirstlivecd.iso" in the qemu emulator, for example - -More advanced stuff -+++++++++++++++++++ - -If you manually modify some stuff in /tmp/libmorphix-<randomsequence> (e.g., /tmp/libmorphix-9oVKWq) , you have to use the following command to recompress the mainmod: "module-builder /tmp/libmorphix-9oVKWq aquamorph_20051120a.mod" (or whatever you want to call the mainmodule). - - Morphix ISO README ------------------ If you're wondering what the directories on the cdrom do, this is the right @@ -229,7 +176,6 @@ In short: mainmodules contain your filesystem, except for your kernel, loadable kernel modules, and hardware detection scripts. - indexterm:minimod[minimod] 'o /minimod ' + contains minimodules, again these are cloop images. @@ -265,9 +211,154 @@ as these files are executed after being swapped. Great fun ;) -Morphing Morphix tools ----------------------- +Fast Introduction to building your own Morphix based livecd +------------------------------------------------------------ +Really Fast Introduction +~~~~~~~~~~~~~~~~~~~~~~~~ + +* Get a Morphix Base iso +* Add "deb http://www.morphix.org/debian ./" to your /etc/apt/source.list +* apt-get update ; apt-get install morphing-tools +* Edit mymainmod.xml +* mmaker mymainmod.xml myprograms.mod +* make-iso /path/source myfirstlivecd.iso + +Fast Introduction +~~~~~~~~~~~~~~~~~ + +Foreplay +^^^^^^^^ + +* Use a Debian based Linux distro [preferably Debian sid, aka unstable, but every recent one should do] +* Get a morphix based .iso [or better: just a base .iso, preferably a stable one atm, like 0.5-pre5 or an autobuilded base .iso] +* Open a root terminal [su -, you get the point] +* mount -t iso9660 -o loop nameoftheisoyoudownloaded.iso /mnt/whatever +* cp -a /mnt/whatever/* /path/to/the/extracted/stuff [like /scratch/iso] + +Setting up the build environment +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +* Add "deb http://www.morphix.org/debian ./" to your /etc/apt/source.list +* apt-get update +* apt-get install morphing-tools + +Creating your own mainmodule +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +* See this manual about mmaker for building an .xml file describing your mainmodule, which will basically be your system +* If you're done with the .xml file [e.g., mymainmod.xml], type "mmaker mymainmod.xml myprograms.mod" or whatever you like to name them + +Building an .iso out of it +^^^^^^^^^^^^^^^^^^^^^^^^^^ + +* Now, remove the files in /scratch/iso/mainmod +* Copy/move your myprograms.mod into /scratch/iso/mainmod +* make-iso /scratch/iso myfirstlivecd.iso +* Done. Burn to cd with your favorite burn program or run with "qemu -cdrom myfirstlivecd.iso" in the qemu emulator, for example + +More advanced stuff +^^^^^^^^^^^^^^^^^^^ + +If you manually modify some stuff in /tmp/libmorphix-<randomsequence> (e.g., /tmp/libmorphix-9oVKWq) , you have to use the following command to recompress the mainmod: "module-builder /tmp/libmorphix-9oVKWq aquamorph_20051120a.mod" (or whatever you want to call the mainmodule). + + +HowTo: Building a new LiveCD in two commands +-------------------------------------------- +indexterm:HowToLiveCD[HowToLiveCD] + +* <<SettingUptheBuildEnvironment, Setting Up the Build Environment>> +* <<GettingtheTemplatesandmainGraphicsFile, Getting the Templates and main Graphics File>> +* <<IsoMakerExmaple, Two Commands>> +* <<HowDoesItLook, Volia One LiveCD>> + +[[SettingUptheBuildEnvironment]] + +Setting up the build environment +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +* Add "deb http://www.morphix.org/debian ./" to your /etc/apt/source.list +* apt-get update +* apt-get install morphing-tools + +[[GettingtheTemplatesandmainGraphicsFile]] +Getting the Templates and main Graphics File +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +* http://svn.sourceforge.net/viewcvs.cgi/morphix/trunk/mmaker/templates/basemod-2.6.9.xml?view=markup[Base Module Tempate] +* http://svn.sourceforge.net/viewcvs.cgi/morphix/trunk/mmaker/templates/morphix-livekiosk.xml?view=markup[MainModule Template] +* MiniModule Templates, http://svn.sourceforge.net/viewcvs.cgi/morphix/trunk/scripts-mini/MorphixMini-KioskSetting.xml?view=markup[1] http://svn.sourceforge.net/viewcvs.cgi/morphix/trunk/scripts-mini/MorphixMini-KioskAddins.xml?view=markup[2] + +[NOTE] +.Note on Templates +===================================================================== +These template may point to a local mirror of the debian repository. Uncomment the remote repository and command out the local repository + +For example replace the lines + + <!-- <repository type="debian">ftp://ftp.debian.org/debian</repository> --> + <repository type="debian">http://127.0.0.1/sid/</repository> + +With the lines + + <repository type="debian">ftp://ftp.debian.org/debian</repository> + <!-- <repository type="debian">http://127.0.0.1/sid/</repository> --> +===================================================================== + + +* http://morphix.org/manual/how_tos/images/MorphixLiveKiosk.png[Graphics file used for Rebranding] + +.Graphics File used for Rebranding +==================================================================== +image:../images/MorphixLiveKiosk.png["Rebranded Boot Splash Background", width=400] +==================================================================== + +[[IsoMakerExmaple]] + +Two Commands +~~~~~~~~~~~~ + +Run isomaker then morphix-rebrand (The magic two commands) + +* isomaker -b ./basemod-2.6.15.xml -m ./morphix-livekiosk.xml -n ./MorphixMini-KioskSetting.xml -n ./MorphixMini-KioskAddins.xml -r http://www.morphix.org/debian -p grub-gfxboot-iso-udeb -p morphix-cdrom-misc-udeb -p morphix-grub-menulist-udeb -p morphix-iso-grubtheme ./morphix-livekiosk.iso +* morphix-rebrand ./morphix-livekiosk.iso ./Morphix-LiveKiosk.iso ./Morphix-LiveKiosk.png + +[[HowDoesItLook]] + +Volia One LiveCD +~~~~~~~~~~~~~~~~ + +Isomaker can take about 45 minutes to run. Morphix-rebrand about 2 minutes. + +After this fun you should have a bootable LiveCD + +Boot Menu +^^^^^^^^^ + +image:../images/RebrandBootMenu.png[Rebranded Grub Menu] + +Boot-Up Screen +^^^^^^^^^^^^^^ + +image:../images/RebrandBootSplash.png[Rebranded Boot Splash] + +Or if you press F2 + +image:../images/RebrandBootUp.png[Rebranded Boot Splash Backround] + + +X-Background / Wallpaper +^^^^^^^^^^^^^^^^^^^^^^^^ + +Should be the same as the Graphics file. + +image:../images/MorphixLiveKiosk.png[Rebranded Boot Splash Backround] + + + +Morphix tools +------------- + A number of commandline tools and scripts are provided in order to help you morph. You can find all of these in the Morphix repository, see http://www.morphix.org/debian[] for details. @@ -285,6 +376,7 @@ '- make-iso (morphix-make-iso)' + Creates a bootable ISO from a directory, detects multiple base versions. +indexterm:isomorph[isomorph] '- isomorph (morphix-isomorph)' + Lists modules on an ISO, adds or removes modules from an ISO, and more! @@ -294,6 +386,7 @@ See http://www.morphix.org/wiki/index.php/ModuleMaker[] and documentation in /usr/share/doc/mmaker for details. +indexterm:isomaker[isomaker] '- isomaker (morphix-mmaker)' + Creates an iso, using one or more mmaker template files. See documentation in /usr/share/doc/mmaker for details. @@ -312,7 +405,11 @@ '- addtoiso (morphix-addtoiso)' + Add file to an iso, without having to copy the file all within the image +indexterm:morphix-rebrand[morphix-rebrand] +'- morphix-rebrand (morphix-rebrand)' + + This script Re-brands a Morphix CD image using a single graphics file. + HowTo: Some Examples to help you start Morphing ----------------------------------------------- indexterm:MorphingMorphix[MorphingMorphix] @@ -324,12 +421,17 @@ The purpose of 'Morphing-Morphix' is to provide the quick way to start 'Morphing' and making your own LiveCD. Just boot the CD and start Morphing, no need to install tools, compile applications or switch operating systems. All is required is some space on a connected hard drive. The aim is to be able make new Morphix LiveCDs using this LiveCD, as an introduction to Morphix. In fact this LiveCD was made using Morphing-Morphix. +*The following applies to Morphing-Morphix Version 0.3* +*Version 0.3 is not yet complete* + +*We like to write documentation first then code* + + The following Morphs can be completed from the LiveCD. * <<FirstMorph, My First Morph - change the background>> -* <<BootMenu, Morphing the Boot Menu>> -* <<BootUp,Morphing the Boot-up Process>> +* <<Rebranding, Rebranding>> * <<HomeDir, Morphing the Home Directory>> * <<AutoLaunch, Auto-Launching Firefox>> * <<MainModule, Morphing a MainModule>> @@ -353,9 +455,9 @@ #!/bin/bash #Setting-up mmorphing - sudo mount /mnt/hda3 -o dev - sudo mkdir /mnt/hda3/mmorphix 2>/dev/null - sudo chown mmorph.users /mnt/hda3/mmorphix 2>/dev/null + mount /mnt/hda3 -o dev + mkdir /mnt/hda3/mmorphix 2>/dev/null + chown mmorph.users /mnt/hda3/mmorphix 2>/dev/null mkdir /mnt/hda3/mmorphix/tmp 2>/dev/null mkdir /mnt/hda3/mmorphix/iso 2>/dev/null mkdir /mnt/hda3/mmorphix/morphing 2>/dev/null @@ -366,150 +468,42 @@ #Start of My First Morph Commands mount Morphing-Morphix_0-0-1.iso /mnt/hda3/mmorphix/mnt -o loop -Alas, we can't directly modify the files on the iso. So, as we really want to modify the iso, we need to copy the iso files to a new directory: +Now, where was that background located? Checking the XFCE4 settings, you discover it is located at /morphix/background.png. Not wanting to figure out in which module it is located, you use the /copy-directory instead to copy your new background (located at /mnt/hda3/background.png) over the other one at boot time: - # sudo rm -R /mnt/hda3/mmorphix/morphed - sudo cp -av /mnt/hda3/mmorphix/mnt/* /mnt/hda3/mmorphix/morphed + isomorph --add /mnt/hda3/background.png /morphix/ /mnt/hda3/mmorphix/iso/MyMorph.iso /mnt/hda3/mmorphix/iso/tmp.iso + mv /mnt/hda3/mmorphix/iso/tmp.iso /mnt/hda3/mmorphix/iso/MyMorph.iso -Now, where was that background located? Checking the XFCE4 settings, you discover it is located at /morphix/background.png. Not wanting to figure out in which module it is located, you use the /copy-directory instead to copy your new background (located at ~/mybackground.png) over the other one at boot time: +Well, that was it! The beauty of isomorph - it takes all the hardwork of mounting etc away. - sudo mkdir /mnt/hda3/mmorphix/morphed/copy/morphix/ - sudo cp /mnt/hda3/background.png /mnt/hda3/mmorphix/morphed/copy/morphix/background.png - -Now, lets make us a new CD-ROM iso from this directory: - - sudo /usr/bin/make-iso /mnt/hda3/mmorphix/morphed /mnt/hda3/mmorphix/iso/MyFirstMorph.iso - #End of My First Morph Commands - -Well, that was it! You can burn your iso using your favorite CD-R burning tool, and you're done. One freshly baked live CD with your own background, coming right up: +You can burn your iso using your favorite CD-R burning tool, and you're done. One freshly baked live CD with your own background, coming right up: cdrecord -scanbus cdrecord speed=8 dev=0,0,0 /tmp/mylivecd.iso Of course, this was a pretty simple morph. You can do quite amazing stuff using Morphix without needing to remaster modules directly +[[Rebranding]] -[[BootMenu]] +Rebranding a Morphix ISO +~~~~~~~~~~~~~~~~~~~~~~~~ -Morphing the Boot Menu -~~~~~~~~~~~~~~~~~~~~~~ +The next Morph is to rebrand the iso using a single graphics file. -The next Morph is to rebrand the initial Boot screen and Boot menu. +The following will be changes -The following will be changed +* Grub background +* Grub titles. +* Bootsplash +* Bootsplash background +* Bootsplash messages +* Hostname +* Username +* X Background -* Background Graphic on the boot menu -* Titles used in the boot menu + morphix-rebrand /mnt/hda3/mmorphix/iso/MyMorph.iso /mnt/hda3/mmorphix/iso/tmp.iso /mnt/hda3/MyMorph.png + mv /mnt/hda3/mmorphix/iso/tmp.iso /mnt/hda3/mmorphix/iso/MyMorph.iso -Whilst not directly seen in the boot menu we will also add boot codes to: -* Rebrand the default user name. - - #!/bin/bash - #Setting-up mmorphing - sudo mount /mnt/hda3 -o dev - sudo mkdir /mnt/hda3/mmorphix 2>/dev/null - sudo chown mmorph.users /mnt/hda3/mmorphix 2>/dev/null - mkdir /mnt/hda3/mmorphix/tmp 2>/dev/null - mkdir /mnt/hda3/mmorphix/iso 2>/dev/null - mkdir /mnt/hda3/mmorphix/morphing 2>/dev/null - mkdir /mnt/hda3/mmorphix/morphed 2>/dev/null - mkdir /mnt/hda3/mmorphix/modules 2>/dev/null - mkdir /mnt/hda3/mmorphix/mnt 2>/dev/null - #Setting-up complete - #Start of My First Morph Commands - mount Morphing-Morphix_0-0-1.iso /mnt/hda3/mmorphix/mnt -o loop - # sudo rm -R /mnt/hda3/mmorphix/morphed - sudo cp -av /mnt/hda3/mmorphix/mnt/* /mnt/hda3/mmorphix/morphed - - wget http://www.morphix.org/debian/binaries/morphix-iso-grubtheme_0.1-4.tar.gz - tar zxvf ./morphix-iso-grubtheme_0.1-4.tar.gz - gimp ./gfxboot-grub-0.1/background.pcx - cd ./gfxboot-grub-0.1/ - sudo make - cd .. - sudo cp ./gfxboot-grub-0.1/boot/message /mnt/hda3/mmorphix/morphed/boot/grub - OLD_TITLE=$(grep -e "title" -m 1 /mnt/hda3/mmorphix/morphed/boot/grub/menu.lst/ | sed s/title\ //g) - for TMP_GRUB_FILE in /mnt/hda3/mmorphix/morphed/boot/grub/*.lst - do - #Remove Old username - sed "/kernel/s/username=.* //g" /mnt/hda3/mmorphix/morphed/boot/grub/options.lst >/tmp/mmorphix.7322 - sed "/kernel/s/$/ AnotherBootOption/" /tmp/mmorphix.7322 >/mnt/hda3/mmorphix/morphed/boot/grub/options.lst - sed "/title/s/$OLD_TITLE/NewTitle/g" /tmp/mmorphix_.7322 >/tmp/mmorphix.7322 - sudo cp /tmp/mmorphix.7322 /mnt/hda3/mmorphix/morphed/boot/grub/options.lst - done - sudo /usr/bin/make-iso /mnt/hda3/mmorphix/morphed /mnt/hda3/mmorphix/iso/My_Morph_2.iso - - -[[BootUp]] - -Morphing the Boot-up Process -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The next Morph is to rebrand the messages and screens shown -during the boot process. - -The following will be changed - -* Background Messages -* Boot-Splash Images -* Background Images - -Again the command used will be saved in a script for further hacking. - - #!/bin/bash - #Setting-up mmorphing - sudo mount /mnt/hda3 -o dev - sudo mkdir /mnt/hda3/mmorphix 2>/dev/null - sudo chown mmorph.users /mnt/hda3/mmorphix 2>/dev/null - mkdir /mnt/hda3/mmorphix/tmp 2>/dev/null - mkdir /mnt/hda3/mmorphix/iso 2>/dev/null - mkdir /mnt/hda3/mmorphix/morphing 2>/dev/null - mkdir /mnt/hda3/mmorphix/morphed 2>/dev/null - mkdir /mnt/hda3/mmorphix/modules 2>/dev/null - mkdir /mnt/hda3/mmorphix/mnt 2>/dev/null - #Setting-up complete - #Start of My First Morph Commands - mount Morphing-Morphix_0-0-1.iso /mnt/hda3/mmorphix/mnt -o loop - # sudo rm -R /mnt/hda3/mmorphix/morphed - sudo cp -av /mnt/hda3/mmorphix/mnt/* /mnt/hda3/mmorphix/morphed - - mkdir /tmp/minir 2>/dev/null - sudo rm /tmp/miniroot.gz -f - cp /mnt/hda3/mmorphix/morphed/boot/miniroot.gz /tmp/ - cd /tmp/ - sudo rm /tmp/miniroot -f - gunzip ./miniroot.gz - sudo mount ./miniroot /tmp/minir -o loop - # Uncomment if you are not using Morphing-MorphixCD - #sed "s/_MORPHIX/ZZ_TMP_ZZ/g" /tmp/minir/linuxrc >/tmp/mmorphix.7587 - #sed "s/DEBUGMORPHIX/ZZ_TMP2_ZZ/g" /tmp/mmorphix.7587 >/tmp/mmorphix_.7587 - # Comment if you are not using Morphing-MorphixCD - sed "s/Morphing-Morphix/RebrandedName/g" /tmp/mmorphix_.7587 >/tmp/mmorphix.7587 - #sed "s/ZZ_TMP_ZZ/_MORPHIX/g" /tmp/mmorphix_.7587 >/tmp/mmorphix.7587 - #sed "s/ZZ_TMP2_ZZ/DEBUGMORPHIX/g" /tmp/mmorphix.7587 >/tmp/mmorphix_.7587 - #mv /tmp/mmorphix.7587 /tmp/mmorphix_.7587 - sudo cp /tmp/mmorphix.7587 /tmp/minir/linuxrc - convert /mnt/hda3/background.jpg -resize 1024x768 /tmp/silent-1024x768.jpg - convert /mnt/hda3/background.jpg -modulate 5,10,10 /tmp/bootsplash-1024x768.jpg - sudo cp /tmp/silent-1024x768.jpg /tmp/minir/bootsplash/images/ - sudo cp /tmp/silent-1024x768.jpg /tmp/minir/bootsplash/images/silent5-1024x768.jpg - sudo cp /tmp/silent-1024x768.jpg /tmp/minir/bootsplash/images/silent4-1024x768.jpg - sudo cp /tmp/silent-1024x768.jpg /tmp/minir/bootsplash/images/silent3-1024x768.jpg - sudo cp /tmp/silent-1024x768.jpg /tmp/minir/bootsplash/images/silent2-1024x768.jpg - sudo cp /tmp/bootsplash-1024x768.jpg /tmp/minir/bootsplash/images/ - sudo rm /tmp/bootsplash-1024x768.jpg - sudo rm /tmp/silent-1024x768.jpg - sudo sync - sudo umount /tmp/miniroot /var/tmp/miniroot - sudo rm /tmp/miniroot.gz -f - cd /tmp/ - gzip ./miniroot - sudo cp /tmp/miniroot.gz /mnt/hda3/mmorphix/morphed/boot/miniroot.gz - sudo rm /tmp/miniroot.gz -f - sudo /usr/bin/make-iso /mnt/hda3/mmorphix/morphed /mnt/hda3/mmorphix/iso/My_Morph.iso - - [[HomeDir]] Morphing the Home Directory @@ -526,8 +520,9 @@ * The X server setting - these are generated on boot up. - sudo /usr/sbin/make-mini --homedir --hidden /mnt/hda3/mmorphix/morphed/minimod/Morphix-Mini-Saved-Home.mod - sudo /usr/bin/make-iso /mnt/hda3/mmorphix/morphed /mnt/hda3/mmorphix/iso/My_Morph.iso + make-mini --homedir --hidden /mnt/hda3/mmorphix/morphed/minimod/Morphix-Mini-Saved-Home.mod + isomorph --add mini /mnt/hda3/mmorphix/morphed/minimod/Morphix-Mini-Saved-Home.mod /mnt/hda3/mmorphix/iso/MyMorph.iso /mnt/hda3/mmorphix/iso/tmp.iso + mv /mnt/hda3/mmorphix/iso/tmp.iso /mnt/hda3/mmorphix/iso/MyMorph.iso [[AutoLaunch]] @@ -537,12 +532,10 @@ The next Morph is make a minimodule to autorun an application once the window manager has loaded. -This Morph is to demostrate the use of one of the morphix tools - minimod-gen +This Morph is to demostrate the use of one of the morphix tools - morphmini +*TO be Complete* -Basically minimod-gen is a command line tool, entirely menu driven to help build minimodules. Just answer some simple questions and out pops your minimodule. -Please see isomorph --add boot option - [[MainModule]] Morphing a MainModule @@ -602,7 +595,7 @@ [[AutoBuilding]] Auto-Building Morphix Modules -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ We will take a look at Module Maker, or MMaker, a tool for autobuilding Morphix modules. Remastering modules is all fine and well, and you can do this just as you can with a compressed KNOPPIX image. However, laziness is seen as a virtue in Morphix-land: one command is all it should take to (re)build a module. A look at a module generator @@ -751,83 +744,7 @@ http://ibuild.livecd.net/[] http://wiki.livecd.net/livecd/IbuildHowto[] -HowTo: Building a new LiveCD in two commands --------------------------------------------- -indexterm:HowToLiveCD[HowToLiveCD] -* <<SettingUptheBuildEnvironment, Setting Up the Build Environment>> -* <<GettingtheTemplatesandmainGraphicsFile, Getting the Templates and main Graphics File>> -* <<IsoMakerExmaple, Two Commands>> -* <<HowDoesItLook, Volia One LiveCD>> - -[[SettingUptheBuildEnvironment]] - -Setting up the build environment -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -* Add "deb http://www.morphix.org/debian ./" to your /etc/apt/source.list -* apt-get update -* apt-get install morphing-tools - -[[GettingtheTemplatesandmainGraphicsFile]] -Getting the Templates and main Graphics File -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -* http://svn.sourceforge.net/viewcvs.cgi/morphix/trunk/mmaker/templates/basemod-2.6.9.xml?view=markup[Base Module Tempate] -* http://svn.sourceforge.net/viewcvs.cgi/morphix/trunk/mmaker/templates/morphix-livekiosk.xml?view=markup[MainModule Template] -* MiniModule Templates, http://svn.sourceforge.net/viewcvs.cgi/morphix/trunk/scripts-mini/MorphixMini-KioskSetting.xml?view=markup[1] http://svn.sourceforge.net/viewcvs.cgi/morphix/trunk/scripts-mini/MorphixMini-KioskAddins.xml?view=markup[2] - -NB: The template may point to a local mirror of the debian repository. Uncomment the remote repository and command out the local repository - -* http://morphix.org/manual/how_tos/images/MorphixLiveKiosk.png[Graphics file used for Rebranding] - -.Graphics File used for Rebranding -==================================================================== -image:../images/MorphixLiveKiosk.png["Rebranded Boot Splash Background", width=400] -==================================================================== - -[[IsoMakerExmaple]] - -Two Commands -~~~~~~~~~~~~ - -Run isomaker then morphix-rebrand (The magic two commands) - -* isomaker -b ./basemod-2.6.15.xml -m ./morphix-livekiosk.xml -n ./MorphixMini-KioskSetting.xml -n ./MorphixMini-KioskAddins.xml -r http://www.morphix.org/debian -p grub-gfxboot-iso-udeb -p morphix-cdrom-misc-udeb -p morphix-grub-menulist-udeb -p morphix-iso-grubtheme ./morphix-livekiosk.iso -* morphix-rebrand ./morphix-livekiosk.iso ./Morphix-LiveKiosk.iso ./Morphix-LiveKiosk.png - -[[HowDoesItLook]] - -Volia One LiveCD -~~~~~~~~~~~~~~~~ - -Isomaker can take about 45 minutes to run. Morphix-rebrand about 2 minutes. - -After this fun you should have a bootable LiveCD - -Boot Menu -^^^^^^^^^ - -image:../images/RebrandBootMenu.png[Rebranded Grub Menu] - -Boot-Up Screen -^^^^^^^^^^^^^^ - -image:../images/RebrandBootSplash.png[Rebranded Boot Splash] - -Or if you press F2 - -image:../images/RebrandBootUp.png[Rebranded Boot Splash Backround] - - -X-Background / Wallpaper -^^^^^^^^^^^^^^^^^^^^^^^^ - -Should be the same as the Graphics file. - -image:../images/MorphixLiveKiosk.png[Rebranded Boot Splash Backround] - - Appendix FAQ: Frequently Asked Questions FAQ -------------------------------------------- indexterm:FAQ[Frequently Asked Questions] @@ -1145,7 +1062,6 @@ ------------------ http://www.morphix.org/manual/how_tos/all_man_pages/html/index.html[The man pages are availble as a seperate document] - Appendix Legal Issues --------------------- This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <bms...@us...> - 2006-07-11 21:33:58
|
Revision: 2349 Author: bmsleight Date: 2006-07-11 14:33:39 -0700 (Tue, 11 Jul 2006) ViewCVS: http://svn.sourceforge.net/morphix/?rev=2349&view=rev Log Message: ----------- Typos Modified Paths: -------------- trunk/how_tos/morphix_docbook.txt Modified: trunk/how_tos/morphix_docbook.txt =================================================================== --- trunk/how_tos/morphix_docbook.txt 2006-07-11 21:16:53 UTC (rev 2348) +++ trunk/how_tos/morphix_docbook.txt 2006-07-11 21:33:39 UTC (rev 2349) @@ -292,7 +292,7 @@ [NOTE] .Note on Templates ===================================================================== -These template may point to a local mirror of the debian repository. Uncomment the remote repository and command out the local repository +These templates may point to a local mirror of the debian repository. Un-comment the remote repository and comment out the local repository. For example replace the lines @@ -321,7 +321,7 @@ Run isomaker then morphix-rebrand (The magic two commands) * isomaker -b ./basemod-2.6.15.xml -m ./morphix-livekiosk.xml -n ./MorphixMini-KioskSetting.xml -n ./MorphixMini-KioskAddins.xml -r http://www.morphix.org/debian -p grub-gfxboot-iso-udeb -p morphix-cdrom-misc-udeb -p morphix-grub-menulist-udeb -p morphix-iso-grubtheme ./morphix-livekiosk.iso -* morphix-rebrand ./morphix-livekiosk.iso ./Morphix-LiveKiosk.iso ./Morphix-LiveKiosk.png +* morphix-rebrand ./morphix-livekiosk.iso ./MorphixLiveKiosk.iso ./MorphixLiveKiosk.png [[HowDoesItLook]] This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <bms...@us...> - 2006-09-04 22:06:21
|
Revision: 2410 http://svn.sourceforge.net/morphix/?rev=2410&view=rev Author: bmsleight Date: 2006-09-04 15:06:14 -0700 (Mon, 04 Sep 2006) Log Message: ----------- first post^D^D^D^D commit Modified Paths: -------------- trunk/how_tos/morphix_docbook.txt Modified: trunk/how_tos/morphix_docbook.txt =================================================================== --- trunk/how_tos/morphix_docbook.txt 2006-09-04 20:18:34 UTC (rev 2409) +++ trunk/how_tos/morphix_docbook.txt 2006-09-04 22:06:14 UTC (rev 2410) @@ -413,140 +413,167 @@ Some 'updated' How Tos to help you get started with Morphing. These HowTos are available on interacive 'How To' LiveCD called 'Morphing-Morphix', much better than a boring document. -A look at Morphing-Morphix -~~~~~~~~~~~~~~~~~~~~~~~~~~ +A look at MorphingMorphix 0.3 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The purpose of 'Morphing-Morphix' is to provide the quick way to start 'Morphing' and making your own LiveCD. Just boot the CD and start Morphing, no need to install tools, compile applications or switch operating systems. All is required is some space on a connected hard drive. The aim is to be able make new Morphix LiveCDs using this LiveCD, as an introduction to Morphix. In fact this LiveCD was made using Morphing-Morphix. +The purpose of MorphingMorphix is to provide a quick way +to start Morphing and to showcase all the Morphix tools +- a LiveCD contruction kit. Just boot the CD and start +Morphing, no need to install tools, compile applications or +switch operating systems. All that is required is some space +on a connected hard drive. -You do not have to use Morphing-morphix you just need a debian based system and <<SettingUptheBuildEnvironment, Set Up the Build Environment>> +You do not have to use MorphingMorphix you just need a debian based system and <<SettingUptheBuildEnvironment, Set Up the Build Environment>> -*The following applies to Morphing-Morphix Version 0.3* +On MorphingMorphix there are a number of interactive +HowTo/examples. The examples work best if you work though +them in order. First configure MorphingMorphix so that some +extra disk space is available. Then work through the +examples in order. -*Version 0.3 is not yet complete* +Some of the examples, such as using mmaker and isomaker +require access to the internet, so that software can be +downloaded from repositories to build new parts of a +MorphixCD. The examples are very machine intensive, +using lots of disk space, memory, and bandwidth. -*We like to write documentation first then code* - - The following Morphs can be completed from the LiveCD. -* <<FirstMorph, My First Morph - change the background>> -* <<Rebranding, Rebranding>> -* <<AutoLaunch, morphmini example - Auto-Launching Firefox>> -* <<HomeDir, Morphing the Home Directory>> +* <<Introduction, Introduction to isomorph>> +* <<Remove, Remove Modules>> +* <<MiniMorphExample, MiniMorph Example>> +* <<HomeDir, Saving files in /home/morph>> * <<AutoBuilding, Auto-Building using mmaker>> * <<MainModule, Morphing a MainModule>> * <<TestQemu, Testing an iso using Qemu>> -Boot the Morphing-Morphix CD, then from the IceWM button select Morphing-Mophix. All off the following morphs are available from the nice graphic menu. -After you have used this interative 'How To' a script is available as /tmp/mmscript.sh This script contain all the commands used in your morphing session. In fact you can use this mmscript to reproduce exactly the same results. The best thing is, you can read thought the commands listed in the script. This will give you an introduction to use some of the morphix tools. +[[Introduction]] -With each of the Morphs beow included is an example output of /tmp/mmscript.sh +Introduction +~~~~~~~~~~~~ +LiveCD are stored as .iso files. Which can then be written +to a CD. One of the morphing-tools is isomorph. This can be +used to manipulate morphix iso files. -[[FirstMorph]] +Isomorph can list, add, del and get files on the Morphix +LiveCDs. -My First Morph - change the background -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Isomorph is used in all of the other examples. -Now we know how a Morphix live CD can be structured, lets make us a new Live CD to illustrate. Even if you only skimmed over the last section, 'morphing' isn't hard to start with. Lets say you want to do something simple, like change the default background of your live CD. +For example we will now run the command + isomorph --list MyMorph.iso -Now, where was that background located? Checking the XFCE4 settings, you discover it is located at /morphix/background.png. Not wanting to figure out in which module it is located, you use the /copy-directory instead to copy your new background (located at ./background.png) over the other one at boot time: +[[Remove]] - isomorph --add ./background.png /morphix/ ./MyMorph.iso ./tmp.iso - mv ./tmp.iso ./MyMorph.iso +Remove Modules +~~~~~~~~~~~~~~ -Well, that was it! The beauty of isomorph - it takes all the hardwork of mounting etc away. +We have now got our CD Image file, by copying this running +CD. As you have seen in the last example, this image +contains the MainModule and lots of MiniModules. The easy +way to make a new LiveCD is to build new MiniModules and a +new MainModule. -You can burn your iso using your favorite CD-R burning tool, and you're done. One freshly baked live CD with your own background, coming right up: - - cdrecord -scanbus - cdrecord speed=8 dev=0,0,0 /tmp/mylivecd.iso +Hence the first task is to delete the MainModule and +MiniModules from the LiveCD image. +Remove Modules -Of course, this was a pretty simple morph. You can do quite amazing stuff using Morphix without needing to remaster modules directly - -[[Rebranding]] - -Rebranding a Morphix ISO -~~~~~~~~~~~~~~~~~~~~~~~~ - -The next Morph is to rebrand the iso using a single graphics file. - -The following will be changed - -* Grub background -* Grub titles. -* Bootsplash -* Bootsplash background -* Bootsplash messages -* Hostname -* Username -* X Background - - morphix-rebrand ./MyMorph.iso ./tmp.iso ./MyMorph.png +We will again use isomorph + isomorph --del-all main ./MyMorph.iso ./tmp.iso mv ./tmp.iso ./MyMorph.iso + isomorph --del-all mini ./MyMorph.iso ./tmp.iso + mv ./tmp.iso ./MyMorph.iso -[[AutoLaunch]] +[[MiniMorphExample]] -morphmini example - Auto-Launching Firefox -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +MiniMorph Example +~~~~~~~~~~~~~~~~~ -The next Morph is make a minimodule to autorun an application once the window manager has loaded. +The next Morph is making the MiniModule to auto run an +application once the window manager has loaded. -This Morph is to demostrate the use of one of the morphix tools - morphmini. This is mmkaer little brother. As in other exmaples this makes use of XML template files. +This Morph is to demonstrate the use of one of the morphix +tools - morphmini. This is mmaker's little brother. As in +other examples this makes use of XML template files. -[NOTE] -.Contents of MiniModuleLaunchFirefox.xml -====================================== --------------------------------------- +---------------------------------------- <comps> <group> <minimod> - <description>MorphMini launch firefox</description> - <minitag>MorphixMini-Firefox</minitag> - <maintag>ALL</maintag> - <commandlist> - <X> - <command>firefox http://www.morphix.org & </command> <!-- & is xml format for & --> + <version>0.0.1</version> + <description>MorphMini launch Morphing-Morphix-GUI</description> + <minitag>MorphixMini-Launch-MM-GUI</minitag> + <maintag>ALL</maintag> + <bootoption>ALL</bootoption> + <root> <!-- Files or Packages to be overlaid on the rootfile system - good for saving ramspace --> + <files> + <local> + <from>/home/morph/morphix/trunk/morph-scripts/mmorphix/morphing-morphix-gui.sh</from> + <to>/usr/sbin/morphing-morphix-gui</to> + </local> + <local> + <from>/home/morph/morphix/trunk/morph-scripts/mmorphix/MorphingMorphix.xpm</from> + <to>/usr/share/morphing-morphix/</to> + </local> + </files> + </root> + <commandlist> <!-- Commands to be started from minimodule --> + <X> <!-- Commands to run in X windows --> + <command>/usr/sbin/morphing-morphix-gui & </command><!-- & is xml format for & --> </X> </commandlist> </minimod> </group> </comps> +---------------------------------------- --------------------------------------- -====================================== - - morphmini ./MiniModuleLaunchFirefox.xml ./MiniModuleLaunchFirefox.mod - isomorph --add mini ./MiniModuleLaunchFirefox.mod ./MyMorph.iso ./tmp.iso - mv ./tmp.iso ./MyMorph.iso +We will now build the MiniModule then add the MiniModule to +the the LiveCD. + morphmini ./MorphixMini-Launch-MM-GUI.xml ./MorphixMini-Launch-MM-GUI.mod + isomorph --add mini ./MorphixMini-Launch-MM-GUI.mod ./MyMorph.iso ./tmp.iso + mv ./tmp.iso ./MyMorph.iso + http://svn.sourceforge.net/viewcvs.cgi/morphix/trunk/scripts-mini/[Other templates for morphmini are available] -By using the <root> tag it is possible to overlay files on top of the base and mainmodule without using an excessive amount of memory.See http://svn.sourceforge.net/viewcvs.cgi/morphix/trunk/morph-scripts/morphmini/example.xml?view=markup[example.xml] for all tags. - [[HomeDir]] Morphing the Home Directory ~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The next Morph is to save the files in the users home directory when you are running the LiveCD. This is great for doing the final tweaks to a LiveCD. Boot the CD, make the minor changes that can only really be done when the LiveCD is running then save these tweaks as a minimodule. +The next Morph is to save the files in the users home +directory. The following will be saved -* Any files and directories in the users home. -* Hidden sitting files. (The are the files beginning with a . e.g. .icewm) +* Any files and directories in /home/morph +* Hidden system files. (These are the files beginning with a . e.g. .icewm) The following will not be saved * The X server setting - these are generated on boot up. - make-mini --homedir --hidden ./Morphix-Mini-Saved-Home.mod - -This miniodule needs to be saved to permanent storage so that we can add to the iso using +Basically all the files and directories in /home/morph will +be zipped into placed in to a self-extracting MiniModule. - isomorph --add mini ./Morphix-Mini-Saved-Home.mod ./MyMorph.iso ./tmp.iso - mv ./tmp.iso ./MyMorph.iso +So feel free to save some files, settings, etc within the +home directory before continuing.This is really useful for +setting default homepages, menus etc. +The power of a MiniModule is that they are very simple to +build, but really useful to change the whole impression of +the cd. + +We make the mini-module using one of the morphix-tools +make-mini, along with isomorph to add the MiniModule to the +image file. + +Commands + make-mini --homedir --hidden MorphixMini-MM-Saved-Home.mod + isomorph --add mini MorphixMini-MM-Saved-Home.mod ./MyMorph.iso ./tmp.iso + mv ./tmp.iso ./MyMorph.iso + [[AutoBuilding]] Auto-Building Morphix Modules @@ -1079,6 +1106,7 @@ Index ----- + //////////////////////////////////////////////////////////////// The index is normally left completely empty, it's contents being generated automatically by the DocBook toolchain. This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <bms...@us...> - 2006-09-04 22:38:01
|
Revision: 2411 http://svn.sourceforge.net/morphix/?rev=2411&view=rev Author: bmsleight Date: 2006-09-04 15:37:50 -0700 (Mon, 04 Sep 2006) Log Message: ----------- Updating manaul to reflect MM_0.3 Modified Paths: -------------- trunk/how_tos/morphix_docbook.txt Modified: trunk/how_tos/morphix_docbook.txt =================================================================== --- trunk/how_tos/morphix_docbook.txt 2006-09-04 22:06:14 UTC (rev 2410) +++ trunk/how_tos/morphix_docbook.txt 2006-09-04 22:37:50 UTC (rev 2411) @@ -263,6 +263,7 @@ HowTo: Building a new LiveCD in two commands -------------------------------------------- indexterm:HowToLiveCD[HowToLiveCD] +[[BuildingLiveCDtwocommands]] * <<SettingUptheBuildEnvironment, Setting Up the Build Environment>> * <<GettingtheTemplatesandmainGraphicsFile, Getting the Templates and main Graphics File>> @@ -443,8 +444,10 @@ * <<Remove, Remove Modules>> * <<MiniMorphExample, MiniMorph Example>> * <<HomeDir, Saving files in /home/morph>> -* <<AutoBuilding, Auto-Building using mmaker>> -* <<MainModule, Morphing a MainModule>> +* <<AutoBuilding, Mmaker Example>> +* <<MainModule, Chrooting a Main Module>> +* <<Rebrand, Rebrand an ISO>> +* <<BuildingwholeISO, Building a whole ISO from Scratch>> * <<TestQemu, Testing an iso using Qemu>> [[Introduction]] @@ -480,6 +483,7 @@ Remove Modules We will again use isomorph + isomorph --del-all main ./MyMorph.iso ./tmp.iso mv ./tmp.iso ./MyMorph.iso isomorph --del-all mini ./MyMorph.iso ./tmp.iso @@ -569,25 +573,40 @@ make-mini, along with isomorph to add the MiniModule to the image file. -Commands make-mini --homedir --hidden MorphixMini-MM-Saved-Home.mod isomorph --add mini MorphixMini-MM-Saved-Home.mod ./MyMorph.iso ./tmp.iso mv ./tmp.iso ./MyMorph.iso [[AutoBuilding]] -Auto-Building Morphix Modules -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Mmaker Example +~~~~~~~~~~~~~~ -We will take a look at Module Maker, or MMaker, a tool for autobuilding Morphix modules. Remastering modules is all fine and well, and you can do this just as you can with a compressed KNOPPIX image. However, laziness is seen as a virtue in Morphix-land: one command is all it should take to (re)build a module. -A look at a module generator +MMaker is a tool that is quite simple in nature. Using a +so-called template, an xml file with all the information +about the module you want to build, you can auto-build a +Morphix MainModule. -MMaker is a tool under development at the moment, but is quite simple in nature. Using a so-called template, an xml file with all the information about the module you want to build, you can auto-build a Morphix module: +That's it kids, we will just have a look at +morphing-morphix.xml used to build this MainModule +currently running. - mmaker mytemplate.xml mymodule.mod +We will then use mmaker to build a new version of the +MainModule. Unless you one of the lucky people who has a +local repository, you will be using the main Debian repository. -What MMaker does when you execute this command is debootstrap a new debian filesystem using the details in the template, set up the necessary mainmodule directories and installs all packages specified in the template, while using apt to handle any dependancies. Afterwards it compresses the whole bunch into a fresh new module, ready to be added to a Morphix Live CD in the usual manner. +You need a fast connection to Debian repository and a lot +of space to build the MainModule before it is compressed. +This step could take up to 45 minutes, but hey it is +automated! + +We will use these commands + + mmaker /usr/share/morphing-morphix/morphing-morphix.xml /tmp/morphing-morphix.mod + isomorph --add main /tmp/morphing-morphix.mod ./MyMorph.iso ./tmp.iso + mv ./tmp.iso ./MyMorph.iso + As you might have guessed, the template is the key to all of this. A look at one for Morphix LightGUI: [note to editor: the template uses an xml notation, so might not appear when viewing in html] <comps> @@ -614,7 +633,7 @@ NB This is a partial template see http://svn.sourceforge.net/viewcvs.cgi/morphix/trunk/mmaker/templates/[] for template examples. -Seems simple, doesn't it? The actual template for LightGUI is quite a bit longer (and contains a package to start xfce4 at boot time), but it's very simple to specify which repositories you want to use, what Debian suite you want, what type of Morphix module you want to autobuild and naturally the packages you want. Currently, MMaker can only build base and main modules . A few tags might need some extra explaining: +Seems simple, doesn't it? The actual template for MorphingMorphix is quite a bit longer (and contains a package to start xfce4 at boot time), but it's very simple to specify which repositories you want to use, what Debian suite you want, what type of Morphix module you want to autobuild and naturally the packages you want. Currently, MMaker can only build base and main modules . A few tags might need some extra explaining: <repository> - With this tag you define the Debian repository/repositories from which to build your module. Use the type="plain" attribute when you have a repository without separate suites (You can verify this by checking the repository, if it has a Packages file in the root directory of the repository we call it 'plain'). Normal, Debian-style repositories is default @@ -639,82 +658,85 @@ [[MainModule]] -Morphing a MainModule -~~~~~~~~~~~~~~~~~~~~~ +Chrooting a Main Module +~~~~~~~~~~~~~~~~~~~~~~~ -The next Morph is make changes to a MainModule, rather than autobuild the module jumo inside the MainModuel and make changes by hand. +One of the easiest ways to modify a MainModule is to +extract the compressed filesystem then change the root +directory to the extracted file system - chroot. -One of the easiest way to modify a MainModule is to extract -the compressed filesystem then change the root directory -to the extracted file system - chroot. - Once you have issued the chroot command it is just like you are running the compressed file system, rather than the current filesystem. You can for example - -* apt-get install new-application +* apt-get install new-applications * Edit configuration files * Have fun .... - #!/bin/bash - #Setting-up mmorphing - sudo mount /mnt/hda3 -o dev - sudo mkdir /mnt/hda3/mmorphix 2>/dev/null - sudo chown mmorph.users /mnt/hda3/mmorphix 2>/dev/null - mkdir /mnt/hda3/mmorphix/tmp 2>/dev/null - mkdir /mnt/hda3/mmorphix/iso 2>/dev/null - mkdir /mnt/hda3/mmorphix/morphing 2>/dev/null - mkdir /mnt/hda3/mmorphix/morphed 2>/dev/null - mkdir /mnt/hda3/mmorphix/mnt 2>/dev/null - #Setting-up complete - #Start of My First Morph Commands - mount Morphing-Morphix_0-0-1.iso /mnt/hda3/mmorphix/mnt -o loop - # sudo rm -R /mnt/hda3/mmorphix/morphed - sudo cp -av /mnt/hda3/mmorphix/mnt/* /mnt/hda3/mmorphix/morphed - #Start Morphing the main-module - sudo -R /mnt/hda3/mmorphix/morphing/* - sudo module-extractor /mnt/hda3/mmorphix/morphed/mainmod/morphing-morphix.mod /mnt/hda3/mmorphix/morphing/ - # resolv.conf required for network - sudo cp /etc/resolv.conf /mnt/hda3/mmorphix/morphing/etc/resolv.conf - sudo chroot /mnt/hda3/mmorphix/morphing/ mount -t proc /proc proc - xterm -e sudo chroot /mnt/hda3/mmorphix/morphing/ - sudo chroot /mnt/hda3/mmorphix/morphing/ umount -lf /proc - sudo rm /mnt/hda3/mmorphix/morphed/mainmod/morphing-morphix.mod - #sudo rm /mnt/hda3/mmorphix/morphed/mainmod/* - sudo module-builder /mnt/hda3/mmorphix/morphing/ /mnt/hda3/mmorphix/morphed/mainmod/morphing-morphix.mod - sudo /usr/bin/make-iso /mnt/hda3/mmorphix/morphed /mnt/hda3/mmorphix/iso/My_Morph.iso +We will now extract the MainModule. This can take a while +as ~800M is extracted. We started then dropped in to the +MainModule root. Once we exit we re-compress the MainModule. +We will use the commands + isomorph --get main ./MyMorph.iso /tmp/ + morphix-chroot /tmp/morphing-morphix.mod + isomorph --add main /tmp/morphing-morphix.mod ./MyMorph.iso ./tmp.iso + mv ./tmp.iso ./MyMorph.iso +[[Rebrand]] + +Rebrand an ISO +~~~~~~~~~~~~~~ +This script Re-brands a Morphix CD image using a graphic +file. + +The following will be changed + +* Grub Titles +* Grub Background +* Username, Hostname +* Boot-up message +* Boot-up background +* Window Manager Wallpaper + +Any Graphic file will do. Rebrand.png, Rebrand.jpg or +Rebrand.gif The name of the graphics file is important as +the script takes Rebrand as the new title for the LiveCD. + +We will use these commands + + morphix-rebrand ./MyMorph.iso ./tmp.iso Rebrand.jpg + mv ./tmp.iso ./MyMorph.iso + +[[BuildingwholeISO]] + +Building a whole ISO from Scratch +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +See <<BuildingLiveCDtwocommands, Building a LiveCD using two commands>> + + [[TestQemu]] Testing an iso using Qemu ~~~~~~~~~~~~~~~~~~~~~~~~~ The next Morph is not really a Morph. It is used to test -other morphs. +other morphs. It is a common tool for Morphers to use. Qemu is a generic and open source processor emulator which achieves a good emulation speed by using dynamic translation. -In short: Boot you LiveCD inside this LiveCD, but a little -slow. Faster than burning a cd and rebooting. Good for -testing +In short: Boot your LiveCD inside your current operating +system. A little slower but faster than burning a cd and +rebooting. Good for testing. - sudo qemu -cdrom ./My_Morph.iso + qemu -boot d -cdrom ./MyMorph.iso -Using iBuild -~~~~~~~~~~~~ - -To be added. In the meantime, see: -http://ibuild.livecd.net/[] -http://wiki.livecd.net/livecd/IbuildHowto[] - - Appendix FAQ: Frequently Asked Questions FAQ -------------------------------------------- indexterm:FAQ[Frequently Asked Questions] This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <bms...@us...> - 2007-10-01 22:41:20
|
Revision: 2558 http://morphix.svn.sourceforge.net/morphix/?rev=2558&view=rev Author: bmsleight Date: 2007-10-01 15:41:17 -0700 (Mon, 01 Oct 2007) Log Message: ----------- Updating Manual Modified Paths: -------------- trunk/how_tos/morphix_docbook.txt Modified: trunk/how_tos/morphix_docbook.txt =================================================================== --- trunk/how_tos/morphix_docbook.txt 2007-09-30 23:55:23 UTC (rev 2557) +++ trunk/how_tos/morphix_docbook.txt 2007-10-01 22:41:17 UTC (rev 2558) @@ -283,34 +283,12 @@ Getting the Templates and main Graphics File ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -* http://svn.sourceforge.net/viewcvs.cgi/morphix/trunk/mmaker/templates/basemod-2.6.9.xml?view=markup[Base Module Tempate] -* http://svn.sourceforge.net/viewcvs.cgi/morphix/trunk/mmaker/templates/morphix-livekiosk.xml?view=markup[MainModule Template] -* MiniModule Templates, http://svn.sourceforge.net/viewcvs.cgi/morphix/trunk/scripts-mini/MorphixMini-KioskSetting.xml?view=markup[1] http://svn.sourceforge.net/viewcvs.cgi/morphix/trunk/scripts-mini/MorphixMini-KioskAddins.xml?view=markup[2] - -[NOTE] -.Note on Templates -===================================================================== -These templates may point to a local mirror of the debian repository. Un-comment the remote repository and comment out the local repository. - -For example replace the lines - - <!-- <repository type="debian">ftp://ftp.debian.org/debian</repository> --> - <repository type="debian">http://127.0.0.1/sid/</repository> - -With the lines - - <repository type="debian">ftp://ftp.debian.org/debian</repository> - <!-- <repository type="debian">http://127.0.0.1/sid/</repository> --> -===================================================================== - - +* http://morphix.svn.sourceforge.net/viewvc/*checkout*/morphix/trunk/mmaker/templates/basemod-2.6.15.xml[Base Module Tempate] +* http://morphix.svn.sourceforge.net/viewvc/*checkout*/morphix/trunk/mmaker/templates/morphix-livekiosk.xml[MainModule Template] +* http://morphix.svn.sourceforge.net/viewvc/*checkout*/morphix/trunk/scripts-mini/MorphixMini-KioskSetting.xml[MiniModule Kiosk Setting] +* Non-Free MiniModule Templates, http://morphix.svn.sourceforge.net/viewvc/*checkout*/morphix/trunk/scripts-mini/MorphixMini-NonFree-Java.xml[1] http://morphix.svn.sourceforge.net/viewvc/*checkout*/morphix/trunk/scripts-mini/MorphixMini-NonFree-FlashPlugin.xml[2] * http://www.morphix.org/doc/how_tos/images/MorphixLiveKiosk.png[Graphics file used for Rebranding] -.Graphics File used for Rebranding -==================================================================== -image:../images/MorphixLiveKiosk.png["Rebranded Boot Splash Background", width=400] -==================================================================== - [[IsoMakerExmaple]] Two Commands @@ -318,7 +296,7 @@ Run isomaker then morphix-rebrand (The magic two commands) -* isomaker -b ./basemod-2.6.15.xml -m ./morphix-livekiosk.xml -n ./MorphixMini-KioskSetting.xml -n ./MorphixMini-KioskAddins.xml -r http://www.morphix.org/debian -p grub-gfxboot-iso-udeb -p morphix-cdrom-misc-udeb -p morphix-grub-menulist-udeb -p morphix-iso-grubtheme ./morphix-livekiosk.iso +* isomaker -b ./basemod-2.6.15.xml -m ./morphix-livekiosk.xml -n ./MorphixMini-KioskSetting.xml -n ./MorphixMini-NonFree-Java.xml -n MorphixMini-NonFree-FlashPlugin.xml -r http://www.morphix.org/debian -p grub-gfxboot-iso-udeb -p morphix-cdrom-misc-udeb -p morphix-grub-menulist-udeb -p morphix-iso-grubtheme ./morphix-livekiosk.iso * morphix-rebrand ./morphix-livekiosk.iso ./MorphixLiveKiosk.iso ./MorphixLiveKiosk.png [[HowDoesItLook]] This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <bms...@us...> - 2007-10-02 21:25:47
|
Revision: 2561 http://morphix.svn.sourceforge.net/morphix/?rev=2561&view=rev Author: bmsleight Date: 2007-10-02 14:25:42 -0700 (Tue, 02 Oct 2007) Log Message: ----------- Updating Manual Modified Paths: -------------- trunk/how_tos/morphix_docbook.txt Modified: trunk/how_tos/morphix_docbook.txt =================================================================== --- trunk/how_tos/morphix_docbook.txt 2007-10-02 21:18:07 UTC (rev 2560) +++ trunk/how_tos/morphix_docbook.txt 2007-10-02 21:25:42 UTC (rev 2561) @@ -283,10 +283,10 @@ Getting the Templates and main Graphics File ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -* http://morphix.svn.sourceforge.net/viewvc/*checkout*/morphix/trunk/mmaker/templates/basemod-2.6.15.xml[Base Module Tempate] -* http://morphix.svn.sourceforge.net/viewvc/*checkout*/morphix/trunk/mmaker/templates/morphix-livekiosk.xml[MainModule Template] -* http://morphix.svn.sourceforge.net/viewvc/*checkout*/morphix/trunk/scripts-mini/MorphixMini-KioskSetting.xml[MiniModule Kiosk Setting] -* Non-Free MiniModule Templates, http://morphix.svn.sourceforge.net/viewvc/*checkout*/morphix/trunk/scripts-mini/MorphixMini-NonFree-Java.xml[1] http://morphix.svn.sourceforge.net/viewvc/*checkout*/morphix/trunk/scripts-mini/MorphixMini-NonFree-FlashPlugin.xml[2] +* http://tinyurl.com/2q535o[Base Module Tempate] +* http://tinyurl.com/33whes[MainModule Template] +* http://tinyurl.com/2lguyr[MiniModule Kiosk Setting] +* Non-Free MiniModule Templates, http://tinyurl.com/2vnra4[1] http://tinyurl.com/2r2l67[2] * http://www.morphix.org/doc/how_tos/images/MorphixLiveKiosk.png[Graphics file used for Rebranding] [[IsoMakerExmaple]] This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <bms...@us...> - 2008-02-26 19:59:49
|
Revision: 2617 http://morphix.svn.sourceforge.net/morphix/?rev=2617&view=rev Author: bmsleight Date: 2008-02-26 11:59:44 -0800 (Tue, 26 Feb 2008) Log Message: ----------- Updated deb http://www.morphix.org/debian unstable/ Modified Paths: -------------- trunk/how_tos/morphix_docbook.txt Modified: trunk/how_tos/morphix_docbook.txt =================================================================== --- trunk/how_tos/morphix_docbook.txt 2008-02-09 16:47:30 UTC (rev 2616) +++ trunk/how_tos/morphix_docbook.txt 2008-02-26 19:59:44 UTC (rev 2617) @@ -215,7 +215,7 @@ ~~~~~~~~~~~~~~~~~~~~~~~~ * Get a Morphix Base iso -* Add "deb http://www.morphix.org/debian ./" to your /etc/apt/source.list +* Add "deb http://www.morphix.org/debian unstable/" to your /etc/apt/source.list * apt-get update ; apt-get install morphing-tools * Edit mymainmod.xml * mmaker mymainmod.xml myprograms.mod @@ -236,7 +236,7 @@ Setting up the build environment ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -* Add "deb http://www.morphix.org/debian ./" to your /etc/apt/source.list +* Add "deb http://www.morphix.org/debian unstable/" to your /etc/apt/source.list * apt-get update * apt-get install morphing-tools @@ -275,7 +275,7 @@ Setting up the build environment ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -* Add "deb http://www.morphix.org/debian ./" to your /etc/apt/source.list +* Add "deb http://www.morphix.org/debian unstable/" to your /etc/apt/source.list * apt-get update * apt-get install morphing-tools @@ -932,7 +932,7 @@ The file should contain the following line - deb http://www.morphix.org/debian ./ + deb http://www.morphix.org/debian unstable/ Then type ('Ctrl-X') to exit and save from nano. This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |