Include(Training/Header)

Meeting Logs

• Meeting log from BOF session at UDS [attachment: 2007-11-1-https://wiki.ubuntu.com/Training/2007-11-01BofLog]

• Meeting log from [attachment:2007-10-18-ubuntu-training.log 18th October]
• Meeting log from [attachment:2007-09-20-ubuntu-training.log 20th September]
• Meeting log from [attachment:2007-09-06-ubuntu-training.log 06th September]
• Meeting log from [attachment:2007-08-23-ubuntu-training.log 23rd August]
• Meeting log from [attachment:2007-08-09-ubuntu-training.log 9th August]

Launchpad and Bazaar

This is a step-by-step guide for creating a branch of the Ubuntu Desktop Course and working on it. The Ubuntu Desktop course is hosted on Launchpad in a bazaar repository (https://launchpad.net/ubuntu-desktop-course)

1. Create a directory on your system, we use ubuntu-desktop-course here
   • $ mkdir ubuntu-desktop-course; cd ubuntu-desktop-course
2. Create a repository to hold branches
   • $ bzr init-repo .
     • [Note the '.' in the above command]
     • This step is not absolutely necessary, but of advantage if you want to have several branches
3. Branch from the desktop course beta

   • $ bzr branch http://bazaar.launchpad.net/~canonical-training/ubuntu-desktop-course/ubuntu-desktop-course-beta ([https://code.launchpad.net/~canonical-training/ubuntu-desktop-course/ubuntu-desktop-course-beta browse])

     • A new directory named ubuntu-desktop-course-beta is created and populated
     • The local branch of the desktop course makes it possible to see the changes you made more easily when offline
4. Create your own branch

   • $ bzr branch ubuntu-desktop-course-beta ubuntu-desktop-course-beta-<NAME OR NICK>

     • This is your working copy
5. Edit and change the XML files
   • Use any editor you like
     • gnome-edit offers syntax highlighting
     • bluefish offers easy use of xmllint to check the XML validity

     • For more options see http://wiki.docbook.org/topic/DocBookAuthoringTools

6. Commit your changes
   • $ bzr commit -m "Example commit, corrected error on bzr usage"
     • Commit after every logical change, e.g. update of a paragraph or list
     • Use sensible commit messages
7. Publish your branch
   • From your branch directory call

     • bzr push bzr+ssh://<LAUNCHPAD USERNAME>@bazaar.launchpad.net/~<LAUNCHPAD USERNAME>/ubuntu-desktop-course/<YOUR BRANCH NAME>

Required packages

To be able to "make" the DocBook source, you may need the following packages: docbook-xsl, xsltproc and dblatex. You can install these using the command line ("sudo apt-get install ...") or the Synaptic package manager.

HOWTO add the Ubuntu Desktop Course on an Ubuntu 7.10 Live CD

with a little help from the UCK (Ubuntu Customization Kit).

Prerequisites:

• a computer with Ubuntu 7.10 running and access to the Internet
• 5 GByte free disk space in $HOME/tmp
• an Ubuntu 7.10 ISO-Image file (700 MByte)
• the Ubuntu Desktop Course file (73 MByte, $HOME/student.pdf for example)

Download uck_2.0.1_all.deb from uck.sourceforge.net and install it.

Open a Terminal window (Applications -> Accessories -> Terminal) and type in the command uck-gui. Answer all the questions the uck-gui asks you...

When the uck-gui asks you "Do you want to customize CD manually during build" then answer "yes"...

When the "Please choose customization action" window appears then let it untouched.

Instead open another Terminal window (Applications -> Accessories -> Terminal) and type in the following commands:

• sudo mkdir $HOME/tmp/remaster-iso/docs
• sudo cp $HOME/student.pdf $HOME/tmp/remaster-iso/docs/
• sudo mkdir $HOME/tmp/remaster-root/etc/skel/Desktop
• sudo ln -s /cdrom/docs/student.pdf $HOME/tmp/remaster-root/etc/skel/Desktop/Ubuntu_Desktop_Course.pdf

Close the Terminal window.

Get back to the "Please choose customization action" window, select "Continue building" and klick on <OK>...

After a while you will find the remastered ISO-Image file as $HOME/tmp/remaster-new-files/livecd.iso (780 MByte).

Burn livecd.iso on a DVD(*) and then boot from this DVD...

You will see an "Ubuntu_Desktop_Course.pdf" icon on the desktop. Klick on the icon to open the Ubuntu Desktop Course.

(*)BE AWARE: If you want to burn livecd.iso on a CD the size of the file has to be less than 700 MByte. To achieve this select "Run package manager" in the "Please choose customization action" window of the uck-gui and remove some software packages you don't need.