Include(Training/Header)

TableOfContents

Meeting Logs

• Meeting log from [attachment:2008-2-7-ubuntu-training.log 7th February]

• 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 translate the Ubuntu Desktop Course

into another language (in collaboration with others).

Prerequisites:

• a launchpad account (https://launchpad.net/+login)

• a computer with Ubuntu 7.10 running and access to the Internet
• a public rsa key in the file ~/.ssh/id_rsa.pub on your computer (*)

(*) If you don't have a public rsa key then create one with the command "ssh-keygen -t rsa".

Login into your launchpad account, go to the "Overview" page of your account and choose "Update SSH keys" from the "Actions" menue. Insert the contents of ~/.ssh/id_rsa.pub into the textbox and click on <Import Public Key>.

Go to the Ubuntu Desktop Course Code page at https://code.launchpad.net/ubuntu-desktop-course and check if there is already a branch for the language you want to translate into (ubuntu-desktop-course-german for example). If there isn't such a branch then you are the first one starting the translation into your language. If you are the first one you should register two branches (ubuntu-desktop-course-german and ubuntu-desktop-course-german-your_name for example). If you are not the first one you have to register only one branch (ubuntu-desktop-course-german-your_name for example). Therefore click on "Register branch" in the "Actions" menue to register your branch(es). Select "Branch Type: Hosted". As "Name" and "Title" type in ubuntu-desktop-course-german-your_name for example.

Now you can create a branch (or two) as a working copy on your computer, start translating and publish your work. For details see "Launchpad and Bazaar" above. Use for example ubuntu-desktop-course-german-your_name only for your own translation work. ubuntu-desktop-course-german should only be used to merge the work of all who are translating into German.

Example 1: Linus is the first one who starts translation into Finnish:

bzr branch http://bazaar.launchpad.net/~canonical-training/ubuntu-desktop-course/ubuntu-desktop-course-beta

bzr branch ubuntu-desktop-course-beta ubuntu-desktop-course-finnish

bzr branch ubuntu-desktop-course-beta ubuntu-desktop-course-finnish-torvalds

After translating in ubuntu-desktop-course-finnish-torvalds:

bzr commit ...

bzr push bzr+ssh://linus-torvalds@bazaar.launchpad.net/~linus-torvalds/ubuntu-desktop-course/ubuntu-desktop-course-finnish-torvalds

After merging all translations in ubuntu-desktop-course-finnish (for example withBR bzr merge ../ubuntu-desktop-course-finnish-torvaldsBR bzr merge ../ubuntu-desktop-course-finnish-raikkonenBR bzr merge ../ubuntu-desktop-course-finnish-halonenBR ...):

bzr commit ...

bzr push bzr+ssh://linus-torvalds@bazaar.launchpad.net/~linus-torvalds/ubuntu-desktop-course/ubuntu-desktop-course-finnish

Example 2: Marie Curie is the third one who starts translation into French (Paula Couvert was the first one):

bzr branch http://bazaar.launchpad.net/~paula-couvert/ubuntu-desktop-course/ubuntu-desktop-course-french

bzr branch ubuntu-desktop-course-french ubuntu-desktop-course-french-curie

After translating in ubuntu-desktop-course-french-curie:

bzr commit ...

bzr push bzr+ssh://marie-curie@bazaar.launchpad.net/~marie-curie/ubuntu-desktop-course/ubuntu-desktop-course-french-curie

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.