KnowledgeBase
7793
Comment:
|
8018
|
Deletions are marked like this. | Additions are marked like this. |
Line 86: | Line 86: |
Example 1: Linus is the first one who starts translation into Finnish: | '''Example 1:''' Linus is the first one who starts translation into Finnish: |
Line 100: | Line 100: |
After merging all translations in ubuntu-desktop-course-finnish: | After merging all translations in ubuntu-desktop-course-finnish (for example with[[BR]] bzr merge ../ubuntu-desktop-course-finnish-torvalds[[BR]] bzr merge ../ubuntu-desktop-course-finnish-raikkonen[[BR]] bzr merge ../ubuntu-desktop-course-finnish-halonen[[BR]] ...): |
Line 106: | Line 110: |
Example 2: Marie is the third one who starts translation into French (Paula Couvert was the first one): | '''Example 2:''' Marie Curie is the third one who starts translation into French (Paula Couvert was the first one): |
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)
- Create a directory on your system, we use ubuntu-desktop-course here
- $ mkdir ubuntu-desktop-course; cd ubuntu-desktop-course
- 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
- $ bzr init-repo .
- 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
- Create your own branch
$ bzr branch ubuntu-desktop-course-beta ubuntu-desktop-course-beta-<NAME OR NICK>
- This is your working copy
- 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
- Use any editor you like
- 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
- $ bzr commit -m "Example commit, corrected error on bzr usage"
- 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>
- From your branch directory call
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 ...
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.
Training/KnowledgeBase (last edited 2009-08-31 10:21:51 by 88-134-43-96-dynip)