Epaath image customization: Difference between revisions

From OLPC
Jump to navigation Jump to search
(added mentioning public repository/loading code updates)
No edit summary
 
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
How to pimp a fresh and clean Etoys image to a luxurious Epaath 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. A public one is available on [http://dev.laptop.org/pub/epaati/etoys-migration-files/ dev.laptop]
For this procedure it's helpful to have the etoys-migration-files directory handy. One can:
<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:



===Get the latest Etoys image===
===Get the latest Etoys image===
Line 14: Line 15:


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


===Import latest changes in Image===

Left-click on world to pop up menu -> update code from server
And wait a bit till all has been downloaded and loaded into the image.




Line 29: Line 24:
===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 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'.
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.
Line 36: Line 31:
===Local patches===
===Local patches===


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




Line 43: Line 38:
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.
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 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 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:
Then execute:
Line 54: Line 49:
We should still submit a proper patch for this.
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.

And we're done.

Note that in general Devanagari can't be rendered properly at the moment. The stuff we did in the preceding section is only meant for rendering of Devanagari letters. The latest news is that someone from the olpc-etoys dev list was working on it. Need to investigate.

Also there's some way to render text properly by importing text from some application programmatically. Look through the olpc etoys mailing list, topic 'Squeak VM status concerning language encodings' for further details.

===sounds===

Just drag all the files from the common-sounds folder under etoys-migration-files into the etoys image. Answer 'save' at the dialog, and accept with the suggested name.

We play all sounds as wavs at the moment. Preferably they would probably be something like ogg files to save mem.



===custom classes===

We should also load a couple of .st files that haven't been integrated into the OLE Monticello package yet. Just file in all files in dir 'class-files' under etoys-migration-files.


===preferences===

Some preferences should also be adjusted. Some are automatically activated with setting the image into production mode which is described below.

The only ones we for now do manually are the preference variables warnIfChangesFileReadOnly and startupInUntrustedDirectory, which we set to false and true respectively (by searching for the concerning variable in world menu > help > preferences).


===XO Game Collection===
===XO Game Collection===


We load the 'XO Game collection.*.pr' (whichever is the latest version, if there are more) project file into the image.
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===
===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. If you think that's a good idea? That's another question.
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.
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.

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.