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. |