Epaath image customization: Difference between revisions

From OLPC
Jump to navigation Jump to search
(init)
 
No edit summary
 
(19 intermediate revisions by 6 users not shown)
Line 1: Line 1:
How to pimp a clean etoys image to a luxurious Epaati image
How to pimp a fresh and clean Etoys image to a luxurious Epaath image


For this procedure it's helpful to have the etoys-migration-files directory handy. One can:
For this procedure it's helpful to have the etoys-migration-files directory handy. This directory is for the moment only situated on one of the [[OLE Nepal]] internal servers (Om's server). We've got a very slow connection to the outside world, so putting it on an external server isn't very practical at the moment. If you, as an external developer, want to work with etoys, you can pull from the soon to be initialized Subversion repository. If it's not there yet, mail us, and we'll find a way.
<pre>git clone git://dev.laptop.org/users/ties/ep-make</pre>
or surf to the directory at [http://dev.laptop.org/pub/epaati/etoys-migration-files/ dev.laptop]


What follows is a step by step instruction:
What follows is a step by step instruction:
Line 8: Line 10:


That would be:
That would be:
[http://tinlizzie.org/olpc/EtoysV3.sources EtoysV3.sources]
[http://tinlizzie.org/olpc/EtoysV3.sources EtoysV3.sources] and [http://tinlizzie.org/olpc/etoys-dev-3.0.zip etoys-dev-3.0.zip]
[http://tinlizzie.org/olpc/etoys-dev-3.0.zip etoys-dev-3.0.zip]


Place EtoysV3.sources in the directory where you've got SqueakV3.sources, and unzip the etoys-dev-3.0.zip to a directory of your preference.
Place EtoysV3.sources in the directory where you've got SqueakV3.sources, and unzip the etoys-dev-3.0.zip to a directory of your preference.

Or just use the stock Etoys image for now. It doesn't really matter.



===Install Monticello===
===Install Monticello===


This is not a straight line procedure, since the standard Etoys image has diverged a bit from the main squeak line. For now see the 'Installing Monticello on your Etoys image' section in [[Etoys Tips and Tricks]].
This is not a straight line procedure, since the standard Etoys image has diverged a bit from the main squeak line. For now see the 'Installing Monticello on your Etoys image' section in [[Etoys Tips and Tricks]].



===Install the latest OLE Monticello package===
===Install the latest OLE Monticello package===


Open a Monticello browser and click +Package. Enter 'OLE' and accept. Then with the (empty) OLE package being highlighted, click +Repository. Change the location into 'http://squeaksource.com/OLE' and leave user and password be. Both should say 'squeak'. Highlight the repository and click Open. Wait for a bit and a new window should open. Select the latest OLE version from the pane on the right and acknowledge that you want to load that version. Forgot what the right word/button is.
Open a Monticello browser and click +Package. Enter 'OLE' and accept. Then with the (empty) OLE package being highlighted, click +Repository and select 'http'. Change the location into ' http://squeaksource.com/OLE ' and leave user and password be. Both should say 'squeak'. Accept. Highlight the repository and click Open. Wait for a bit and a new window should open. Select the latest OLE version from the pane on the right and click 'load'.


And now you should have a new and fresh OLE lib installed.
And now you should have a new and fresh OLE lib installed.


===Local patches===

Go to the changesets directory in the etoys-migration-files directory, and file them in, including the ones in the in-latest-changes subfolder




===Devanagari fonts===
===Devanagari fonts===


Go to the devanagari-fonts directory in the etoys-migration-files directory. Drag the Kalimati.ttf file into your etoys image.
Go to the devanagari-fonts directory in the etoys-migration-files directory. Drag the Devnew.ttf file into your etoys image. Drag a textmorph from your supply-bin, conjure up it's halo, select DevanagariNew and select a point size.

Then again conjure up the halo, select the DevanagariNew font and select 'new size'. Fill in 30, 60, 72, 100, 200, 300 or 400, and repeat the process to add the rest. If you are thrown into the debugger, that's to be expected. We should file a bug report for that if it's not already done.

Then execute:

<pre>
TTCFont registerAll
</pre>

As from [http://dev.laptop.org/ticket/4604].
We should still submit a proper patch for this.

Note that rendering Devenagari has been fixed. This does require updating your image to incorporate the latest changesets. The stuff we did in the preceding section is only meant for rendering of Devanagari letters. We still need to follow the preceding procedure though, cause we need to be backward compatible.

===XO Game Collection===

We load the 'XO Game collection.*.pr' (whichever is the latest version, if there are more than one) project file into the image, which is to be found in etoys-migration-files > misc.



===Setting Image to deploy|author mode|user mode===


If you're going to use the image for developing, click the world to get the world menu, select OLE and select author mode. If you want to see how a user would experience, select 'user mode'. User mode toggles a few values so users don't get bothered by all the options that developers get. Of course one can wonder if that's a good idea, but that's another question.
Rest of description to be followed, but will include:
(to be clear, devanagari can't be rendered properly at the moment. The latest news is that someone from the olpc-etoys dev list was working on it. Need to investigate.)


If you're actually going to use the image for deployment in Nepali schools, select deploy, and also select toggle flaps, to hide the flaps that the OLE developers often use to store objects off-screen.
* Installation of a (non-unicode) devanagari truetype font.
* Pre-initialization of some point sizes for this font: 72, 100, 200, 300.
For numbers




===yes and no sounds===
===Save image===


Save that image!!
Just drag the right01.wav and wrong03.wav files from the common-sounds folder under etoys-migration-files into the etoys folder.


and we're done.
We play all sounds as wavs at the moment. Preferably they would be something like ogg files to save mem.


[[Category:Epaati]]
[[Category:Epaath]]
[[Category:Content]]
[[Category:Content]]
[[Category:Etoys]]
[[Category:Etoys]]
[[Category:Nepal]]
[[Category:Nepal]]
[[Category:OLPC_Nepal]]

Latest revision as of 11:41, 7 September 2008

How to pimp a fresh and clean Etoys image to a luxurious Epaath image

For this procedure it's helpful to have the etoys-migration-files directory handy. One can:

git clone git://dev.laptop.org/users/ties/ep-make

or surf to the directory at dev.laptop

What follows is a step by step instruction:

Get the latest Etoys image

That would be: EtoysV3.sources and etoys-dev-3.0.zip

Place EtoysV3.sources in the directory where you've got SqueakV3.sources, and unzip the etoys-dev-3.0.zip to a directory of your preference.

Or just use the stock Etoys image for now. It doesn't really matter.


Install Monticello

This is not a straight line procedure, since the standard Etoys image has diverged a bit from the main squeak line. For now see the 'Installing Monticello on your Etoys image' section in Etoys Tips and Tricks.


Install the latest OLE Monticello package

Open a Monticello browser and click +Package. Enter 'OLE' and accept. Then with the (empty) OLE package being highlighted, click +Repository and select 'http'. Change the location into ' http://squeaksource.com/OLE ' and leave user and password be. Both should say 'squeak'. Accept. Highlight the repository and click Open. Wait for a bit and a new window should open. Select the latest OLE version from the pane on the right and click 'load'.

And now you should have a new and fresh OLE lib installed.


Local patches

Go to the changesets directory in the etoys-migration-files directory, and file them in, including the ones in the in-latest-changes subfolder


Devanagari fonts

Go to the devanagari-fonts directory in the etoys-migration-files directory. Drag the Devnew.ttf file into your etoys image. Drag a textmorph from your supply-bin, conjure up it's halo, select DevanagariNew and select a point size.

Then again conjure up the halo, select the DevanagariNew font and select 'new size'. Fill in 30, 60, 72, 100, 200, 300 or 400, and repeat the process to add the rest. If you are thrown into the debugger, that's to be expected. We should file a bug report for that if it's not already done.

Then execute:

TTCFont registerAll

As from [1]. We should still submit a proper patch for this.

Note that rendering Devenagari has been fixed. This does require updating your image to incorporate the latest changesets. The stuff we did in the preceding section is only meant for rendering of Devanagari letters. We still need to follow the preceding procedure though, cause we need to be backward compatible.

XO Game Collection

We load the 'XO Game collection.*.pr' (whichever is the latest version, if there are more than one) project file into the image, which is to be found in etoys-migration-files > misc.


Setting Image to deploy|author mode|user mode

If you're going to use the image for developing, click the world to get the world menu, select OLE and select author mode. If you want to see how a user would experience, select 'user mode'. User mode toggles a few values so users don't get bothered by all the options that developers get. Of course one can wonder if that's a good idea, but that's another question.

If you're actually going to use the image for deployment in Nepali schools, select deploy, and also select toggle flaps, to hide the flaps that the OLE developers often use to store objects off-screen.


Save image

Save that image!!

and we're done.