[etoys-dev] [squeakland] New Etoys QuickGuides by Kathleen Harness
bert at freudenbergs.de
Sat Aug 14 20:08:05 EDT 2010
On 15.08.2010, at 01:45, Bert Freudenberg wrote:
> On 14.08.2010, at 01:35, Ted Kaehler wrote:
>> Here is what Bert and I are going to do. The QuickGuides for the new release will be the old QuickGuides plus the "Basic Guides" from Kathleen plus MenuMakeNewFlap that Steve Thomas wanted (I agree).
> I renamed two guides:
> MenuBringtoFront -> MenuBring-toFront
> NavigatorBarHideShow -> NavBarHideShow
> About MenuMakeNewFlap1 - why the 1 at the end? And why does it not recommend the view-source key (alt-comma)? Alt-shift-w is an obscure shortcut for a good reason.
> There are more guides ending in 1: ObjectCatPolygon1 ScriptTileOverlapsDot1 ScriptTileTwoColorTest1
> HaloActiveHandles and MenuTicksPerSecond - mentioned in Ted's mail but I do not have them
> The English index project is broken. I used the old one, did not try to fix it.
> Same for the Spanish one, I had to fix it it. It had a duplicated "layer" of buttons on top ... strange. The Italian index had a screenshot of the buttons on top, too.
>> I'll let Bert reply on how much time you have to make translations.
> End of August will still be fine.
> What I need for each translation is a file mapping file names to titles. It also gives translations for the category titles. We can only use ASCII for the file names, but this file lets us use Unicode for titles. E.g. in German there are accented characters in the title but not the file names.
> I made preliminary index files on my own:
> Spanish http://etoys.squeak.org/svn/trunk/QuickGuides-Projects/es/index.txt
> Portuguese http://etoys.squeak.org/svn/trunk/QuickGuides-Projects/pt/index.txt
> Italian http://etoys.squeak.org/svn/trunk/QuickGuides-Projects/it/index.txt
> German http://etoys.squeak.org/svn/trunk/QuickGuides-Projects/de/index.txt
> French http://etoys.squeak.org/svn/trunk/QuickGuides-Projects/fr/index.txt
> Someone should edit these. Left of the vertical bar "|" is the filename, right of it the translation. Also, it gives the order of the guides in the category so you might want to adjust this.
> There is no French index project yet so I had to use the English one. And there are many guides still missing.
> - Bert -
So I'm basically done with getting the QuickGuides into alpha release form. Ted's code works fine, with a few minor nits.
In the German guides, almost each one appears twice in the menu. I think this happens when the auto-generated title and the one from index.txt differ.
Loading an index book from disk replaces the in-image default index book. Do we even need the in-image book anymore?
OTOH it would be good to have for languages that do not have an index project on their own yet. However that is not working. If there is no index project, the non-English guides do not work, a blank index page is shown.
Also, if there is an index project but the file names do not start with the English category names, they are not found, unless they are listed in an index text file.
For English, the index.txt is needed to give the category titles. But maybe the category titles could be taken from the button labels in the index project? Then, an index text file would only be needed to give the order of guides in each category.
- Bert -
More information about the etoys-dev