Difference between revisions of "Karma/Bundle layout"
< Karma
Jump to navigation
Jump to search
Line 5: | Line 5: | ||
This is what is contained in the repository at http://git.sugarlabs.org/projects/karma/ | This is what is contained in the repository at http://git.sugarlabs.org/projects/karma/ | ||
− | * | + | * Includes script for Karma activity generation, xo bundle generation |
− | |||
* includes "platform" files, i.e. a basic html5-capable browser that can be used to create an xo bundle | * includes "platform" files, i.e. a basic html5-capable browser that can be used to create an xo bundle | ||
Line 18: | Line 17: | ||
INSTALL | INSTALL | ||
karma # This is a shell script that launches karma.js, it just checks if you have java installed so you can run karma.js | karma # This is a shell script that launches karma.js, it just checks if you have java installed so you can run karma.js | ||
+ | # it is inspired partly by rails and [http://docs.djangoproject.com/en/dev/ref/django-admin/ django-admin] administrative scripts | ||
karma.html # The starting page for accessing Karma lessons, should include links to the examples | karma.html # The starting page for accessing Karma lessons, should include links to the examples | ||
karma.js # The main utility script for karma, all it dependencies live in utils/ | karma.js # The main utility script for karma, all it dependencies live in utils/ | ||
Line 24: | Line 24: | ||
default/ | default/ | ||
images/ | images/ | ||
− | karma.pot | + | karma.pot |
sounds/ | sounds/ | ||
locale_name/ | locale_name/ | ||
Line 35: | Line 35: | ||
README | README | ||
utils/ # The [http://www.narwhaljs.org/ narwhal] command-line interpreter for javascript and other utility scripts used by karma.js | utils/ # The [http://www.narwhaljs.org/ narwhal] command-line interpreter for javascript and other utility scripts used by karma.js | ||
+ | |||
+ | == Karma XO bundle == | ||
+ | |||
+ | * similar to E-Paath layout | ||
+ | |||
+ | |||
== Karma lesson bundle == | == Karma lesson bundle == |
Revision as of 09:58, 20 July 2009
The Main Karma Package
Consists of an HTML5 capable browser (activity), a lesson bundle, examples, and utilities to start working with Karma quickly
This is what is contained in the repository at http://git.sugarlabs.org/projects/karma/
- Includes script for Karma activity generation, xo bundle generation
- includes "platform" files, i.e. a basic html5-capable browser that can be used to create an xo bundle
AUTHORS # Should include names of everyone that has contributed to KarmaBuilder ChangeLog COPYING # Licensing information, should default to MIT License ? how distinguish b/w code licensing and content licensing css/ # css/ and js/ contain the code common to all examples, lessons, and karma.html examples/ # working examples of karma lessons js/ # css/ and js/ contain the code common to all examples, lessons, and karma.html INSTALL karma # This is a shell script that launches karma.js, it just checks if you have java installed so you can run karma.js # it is inspired partly by rails and django-admin administrative scripts karma.html # The starting page for accessing Karma lessons, should include links to the examples karma.js # The main utility script for karma, all it dependencies live in utils/ lessons/ # this is the workspace for creating new Karma lessons locale/ # images, sounds, and text common to karma.html, examples, and the lessons default/ images/ karma.pot sounds/ locale_name/ images/ locale_name.json # karma actually needs the .po file to be converted to .json locale_name.po sounds/ NEWS # List of important changes to this package indexed by version platform/ # An html5-capable browser that can be used to create sugar .xo bundle README utils/ # The narwhal command-line interpreter for javascript and other utility scripts used by karma.js
Karma XO bundle
- similar to E-Paath layout
Karma lesson bundle
consists of multiple lesson in a single bundle
- common jquery and css files in a single folder
- preferably a script can be used to generate a lesson bundle with accompanying main menu and search (probably some sort of sitemap)
bundle_name/ mainmenu.html css/ # common css files (e.g. jquery.jgrowl.css and menu.css) js/ # common javascript / jquery files lessons/ # directory for all the lessons lesson_name/
Lesson
consists of a single lesson
lesson_name/ index.html # valid html5 -- markup only includes visual elements and links in other resources, no inline code or styling css/ # css files -- all control of presentation done in CSS karma.css # default stylesheet for Karma lesson_name.css # custom stylesheet for lesson js/ # javascript files karma.js # common javascript functions for a Karma lesson jquery.js, jquery.growl.js # utility functions from jQuery lesson_name.js # javascript controlling logic for the lesson po/ # translation files ne_NP.po # example translation file for Nepal - Nepali sp_ES.po # example translation file for traditional Spanish assets/ ne/ images/ audio/ docs/ lesson plan? teachers note? en/ images/ audio/