Ted,
Having the Standard ones shown first makes sense. But within the sets of standard and user created guides the items are not listed in alphabetical order.
To show what I mean, here is a Screenshot of current ordering: [image: Screen shot 2010-08-26 at 7.30.18 PM.png]
So one possible improvement (for next release, Bert is already over worked) would be to list them in alphabetical order to facilitate easier lookup. The order of the standard one can be easily fixed by sorting the index.txt file (I tried modifying this file it changed the order and it worked. Attached is a sorted version of the file, I did a cross check and it has the same number of lines and also sorted the new and previous versions doing a diff to ensure no unintended changes). Sorting of the user added guides would have to be done in code.
I found a bug in my typing ;) the .pr was at the end, here is a screenshot of the files in the QuickGuides folder: [image: Screen shot 2010-08-26 at 7.32.40 PM.png]you will notice NavBarBob has two versions. When I compare what is displayed in the guide with version 002 they are different. So while the convention is that the largest numbered version is the one fetched, my test on a Macintosh with Etoys Alpha 2 version 4.1 build 2382 shows the version 001 being fetched.
The work around is simple I just need to ensure there is only one version in the directory.
Thanks, Stephen
On Thu, Aug 26, 2010 at 7:06 PM, Ted Kaehler Ted@vpri.org wrote:
Steve, If you name the project "NavBarBob.001.pr" instead of "NavBarBob.pr.001", everything should work normally. Our convention is that .pr is the extension. The version number is before that. The largest numbered version will be the one fetched. If there is any issue, just remove all but the latest version. In the JumpTo menu, the standard known categories appear first, and then the new ones.
--Ted.
At 8:32 AM -0400 8/26/10, Steve Thomas wrote:
Thanks folks, got it working.
Couple of minor points:
After I copy the .pr file to QuickGuides, I need to click on the"?" icon to close and then re-open the guides for my new help page to be visible. 2. If I copy two files into QuickGuides: NavBarBob.pr.001 and NavBarBob.pr.002 the file used is the .001 version 3. If I name the file with numbers at the end the name (ex: NavBarBob2.pr.001) the numbers do not show up. 4. Noticed the "pick lists" (the list of "help topic" you see when clicking on an item in index or from "jump to..." is not in alphabetical order. 5. If you have multiple books (and other things) in the saved project it only shows one of the books. You can also get a book from the Supplies Bin and it works fine. The advantage of copying from the "Help" flap is the book is sized consistent with the other Guides and the flap. So it seems it opens the .pr on demand and "imports" the first book object it finds nto the Help flap, cool.
This could be used for things other than QuickGuides, such a personal object catalog of items you create for re-use in other projects. You would probably want a different flap for that and a way to easily access that flap perhaps from the Sugar Navigator Flap. Also you would probably want a special directory for those items which is language independent.
Thanks, Stephen
-- Ted Kaehler Viewpoints Research Institute http://www.vpri.org/html/team_bios/kaehler.html _______________________________________________ squeakland mailing list squeakland@squeakland.org http://lists.squeakland.org/mailman/listinfo/squeakland
On Fri, Aug 27, 2010 at 9:10 AM, Steve Thomas sthomas1@gosargon.com wrote:
Ted, Having the Standard ones shown first makes sense. But within the sets of standard and user created guides the items are not listed in alphabetical order. To show what I mean, here is a Screenshot of current ordering: So one possible improvement (for next release, Bert is already over worked) would be to list them in alphabetical order to facilitate easier lookup. The order of the standard one can be easily fixed by sorting the index.txt file (I tried modifying this file it changed the order and it worked. Attached is a sorted version of the file, I did a cross check and it has the same number of lines and also sorted the new and previous versions doing a diff to ensure no unintended changes). Sorting of the user added guides would have to be done in code.
Why not adding user written articles to index.txt? I think that making all articles included in index.txt and adjusting order would be important; alphabetical order don't always work (especially for some languages).
/Korakurider
I found a bug in my typing ;) the .pr was at the end, here is a screenshot of the files in the QuickGuides folder: you will notice NavBarBob has two versions. When I compare what is displayed in the guide with version 002 they are different. So while the convention is that the largest numbered version is the one fetched, my test on a Macintosh with Etoys Alpha 2 version 4.1 build 2382 shows the version 001 being fetched. The work around is simple I just need to ensure there is only one version in the directory. Thanks, Stephen
On Thu, Aug 26, 2010 at 7:06 PM, Ted Kaehler Ted@vpri.org wrote:
Steve, If you name the project "NavBarBob.001.pr" instead of "NavBarBob.pr.001", everything should work normally. Our convention is that .pr is the extension. The version number is before that. The largest numbered version will be the one fetched. If there is any issue, just remove all but the latest version. In the JumpTo menu, the standard known categories appear first, and then the new ones.
--Ted.
At 8:32 AM -0400 8/26/10, Steve Thomas wrote:
Thanks folks, got it working.
Couple of minor points:
- After I copy the .pr file to QuickGuides, I need to click on the "?" icon to close and then re-open the guides for my new help page to be visible.
- If I copy two files into QuickGuides: NavBarBob.pr.001 and NavBarBob.pr.002 the file used is the .001 version
- If I name the file with numbers at the end the name (ex: NavBarBob2.pr.001) the numbers do not show up.
- Noticed the "pick lists" (the list of "help topic" you see when clicking on an item in index or from "jump to..." is not in alphabetical order.
- If you have multiple books (and other things) in the saved project it only shows one of the books. You can also get a book from the Supplies Bin and it works fine. The advantage of copying from the "Help" flap is the book is sized consistent with the other Guides and the flap. So it seems it opens the .pr on demand and "imports" the first book object it finds nto the Help flap, cool.
This could be used for things other than QuickGuides, such a personal object catalog of items you create for re-use in other projects. You would probably want a different flap for that and a way to easily access that flap perhaps from the Sugar Navigator Flap. Also you would probably want a special directory for those items which is language independent.
Thanks, Stephen
-- Ted Kaehler Viewpoints Research Institute http://www.vpri.org/html/team_bios/kaehler.html _______________________________________________ squeakland mailing list squeakland@squeakland.org http://lists.squeakland.org/mailman/listinfo/squeakland
squeakland mailing list squeakland@squeakland.org http://lists.squeakland.org/mailman/listinfo/squeakland
On 27.08.2010, at 08:16, Korakurider wrote:
On Fri, Aug 27, 2010 at 9:10 AM, Steve Thomas sthomas1@gosargon.com wrote:
Ted, Having the Standard ones shown first makes sense. But within the sets of standard and user created guides the items are not listed in alphabetical order. To show what I mean, here is a Screenshot of current ordering: So one possible improvement (for next release, Bert is already over worked) would be to list them in alphabetical order to facilitate easier lookup. The order of the standard one can be easily fixed by sorting the index.txt file (I tried modifying this file it changed the order and it worked. Attached is a sorted version of the file, I did a cross check and it has the same number of lines and also sorted the new and previous versions doing a diff to ensure no unintended changes). Sorting of the user added guides would have to be done in code.
Why not adding user written articles to index.txt? I think that making all articles included in index.txt and adjusting order would be important; alphabetical order don't always work (especially for some languages).
/Korakurider
Agreed.
The guides are not a reference manual. I prefer them to be ordered by increasing complexity - basic things first.
- Bert -
Folks,
Why not adding user written articles to index.txt? I think that making all articles included in index.txt and adjusting order would be important; alphabetical order don't always work (especially for some languages).
Yes, the proper way to control the order of guides is to put its name into the file index.txt (in the Quickguides folder for your language). I wanted to make sure that a teacher can add her own Quickguide without needing to know anything about index.txt. Many thanks to Korakurider for establishing index.txt as a way to show names with the proper accents (in UTF-8) and to control the order of guides.
--Ted.
squeakland@lists.squeakfoundation.org
-
Bert Freudenberg -
Korakurider -
Steve Thomas -
Ted Kaehler