Ted,
Please define "latest Etoys version": Etoys 4.0 2336, Etoys 4.1 alpha 2 or Etoys Dev Image after "update code from server"
Where do I find "keep the current project", is this available in "Etoys friendly" mode?
Thanks, Stephen
On Wed, Aug 25, 2010 at 1:03 PM, Ted Kaehler Ted@vpri.org wrote:
Folks, There is a very useful new feature in the latest EToys version. Anyone can make Quickguides. If you are teaching a curriculum, you can create subject-matter guides for your material. Your new guides will not appear directly on the help index page. Instead, look in the "Jump To..." menu at the lower right of the QuickGuides. Your guides will appear in a new category. It will be at the bottom of the "Jump To..." menu.
To create a new guide:Click the Help button [?] to see a guide. Open a halo on the flap. Copy the bookmorph out of the flap. Use the halos to completely change the contents. Create help pages for your new topic. A guide can have as many pages as you want (more than 4 is OK). When you are done, write the entire project out using "Keep the current project". It is now a .pr file. Name your guide using capitals to start words. The first word is the category. All guides in a category start with the same word. Put the .pr file into the QuickGuides folder of your language. Close and open Quickguides. (Click the Help button [?] once to close help, and once again to open it.) Look in the "Jump To..." menu to see your category and guides.
(If the instructions are unclear, please post a corrected version.) (Thank you to Kathleen Harness for showing us how creative QuickGuides can be.)
--Ted.
-- 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 26.08.2010, at 02:00, Steve Thomas wrote:
Ted,
Please define "latest Etoys version": Etoys 4.0 2336, Etoys 4.1 alpha 2 or Etoys Dev Image after "update code from server"
It will be in 4.1, and is ready to be tested in Alpha 2.
Where do I find "keep the current project"
Simply save the project. Under Sugar saving is called "keeping in Journal".
, is this available in "Etoys friendly" mode?
Most certainly ;)
The English guides are in Contents/Resources/QuickGuides. The translated ones in Content/Resources/locale/xy/QuickGuides. (I wonder if it wouldn't be simpler if we moved the English guides there, too)
Ted's method works best with Etoys-To-Go. Its contents is writable, and it's easy to zip up and distribute.
On the Mac, the QuickGuides folders are hidden inside the Etoys application icon. You have to choose "show package contents" in the Finder's menu.
In a regular (not to-go) Linux installation, the QuickGuides are in /usr/share/etoys. You would need root access to put files there.
Under Sugar there is no convenient way to copy a project out of the Journal, and to that location. You would have to use the "copy-from-journal" command in the Terminal activity.
- Bert -
Thanks, Stephen
On Wed, Aug 25, 2010 at 1:03 PM, Ted Kaehler Ted@vpri.org wrote: Folks, There is a very useful new feature in the latest EToys version. Anyone can make Quickguides. If you are teaching a curriculum, you can create subject-matter guides for your material. Your new guides will not appear directly on the help index page. Instead, look in the "Jump To..." menu at the lower right of the QuickGuides. Your guides will appear in a new category. It will be at the bottom of the "Jump To..." menu.
To create a new guide:Click the Help button [?] to see a guide. Open a halo on the flap. Copy the bookmorph out of the flap. Use the halos to completely change the contents. Create help pages for your new topic. A guide can have as many pages as you want (more than 4 is OK). When you are done, write the entire project out using "Keep the current project". It is now a .pr file. Name your guide using capitals to start words. The first word is the category. All guides in a category start with the same word. Put the .pr file into the QuickGuides folder of your language. Close and open Quickguides. (Click the Help button [?] once to close help, and once again to open it.) Look in the "Jump To..." menu to see your category and guides.
(If the instructions are unclear, please post a corrected version.) (Thank you to Kathleen Harness for showing us how creative QuickGuides can be.)
--Ted.
-- 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
Thanks folks, got it working.
Couple of minor points:
1. 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
On Thu, Aug 26, 2010 at 4:58 AM, Bert Freudenberg bert@freudenbergs.dewrote:
On 26.08.2010, at 02:00, Steve Thomas wrote:
Ted,
Please define "latest Etoys version": Etoys 4.0 2336, Etoys 4.1 alpha 2 or Etoys Dev Image after "update code from server"
It will be in 4.1, and is ready to be tested in Alpha 2.
Where do I find "keep the current project"
Simply save the project. Under Sugar saving is called "keeping in Journal".
, is this available in "Etoys friendly" mode?
Most certainly ;)
The English guides are in Contents/Resources/QuickGuides. The translated ones in Content/Resources/locale/xy/QuickGuides. (I wonder if it wouldn't be simpler if we moved the English guides there, too)
Ted's method works best with Etoys-To-Go. Its contents is writable, and it's easy to zip up and distribute.
On the Mac, the QuickGuides folders are hidden inside the Etoys application icon. You have to choose "show package contents" in the Finder's menu.
In a regular (not to-go) Linux installation, the QuickGuides are in /usr/share/etoys. You would need root access to put files there.
Under Sugar there is no convenient way to copy a project out of the Journal, and to that location. You would have to use the "copy-from-journal" command in the Terminal activity.
- Bert -
Thanks, Stephen
On Wed, Aug 25, 2010 at 1:03 PM, Ted Kaehler Ted@vpri.org wrote:
Folks, There is a very useful new feature in the latest EToys version. Anyone can make Quickguides. If you are teaching a curriculum, you can create subject-matter guides for your material. Your new guides will not appear directly on the help index page. Instead, look in the "Jump To..." menu at the lower right of the QuickGuides. Your guides will appear in a new category. It will be at the bottom of the "Jump To..." menu.
To create a new guide:Click the Help button [?] to see a guide. Open a halo on the flap. Copy the bookmorph out of the flap. Use the halos to completely change the contents. Create help pages for your new topic. A guide can have as many pages as you want (more than 4 is OK). When you are done, write the entire project out using "Keep the current project". It is now a .pr file. Name your guide using capitals to start words. The first word is the category. All guides in a category start with the same word. Put the .pr file into the QuickGuides folder of your language. Close and open Quickguides. (Click the Help button [?] once to close help, and once again to open it.) Look in the "Jump To..." menu to see your category and guides.
(If the instructions are unclear, please post a corrected version.) (Thank you to Kathleen Harness for showing us how creative QuickGuides can be.)
--Ted.
-- 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
squeakland mailing list squeakland@squeakland.org http://lists.squeakland.org/mailman/listinfo/squeakland
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
squeakland@lists.squeakfoundation.org
-
Bert Freudenberg -
Steve Thomas -
Ted Kaehler