Changes

Jump to navigation Jump to search
120 bytes removed ,  00:55, 10 March 2010
Line 8: Line 8:  
* 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
   −
 
+
ROOT/                              ( ROOT is not actually a directory name, it just labels the top-level of this package )
     assets/                        ( images, sounds, and text common to karma.html, examples, and the lessons )
+
     assets/                        ( images, audio, and text common to karma.html, examples, and the lessons for the launch page for all lessons )
           default/
+
           image/
                  images/
+
          audio/
                  sounds/
   
           locale_name/
 
           locale_name/
                     images/             
+
                     image/             
 
                     locale_name.json  ( karma actually needs the .po file to be converted to .json )
 
                     locale_name.json  ( karma actually needs the .po file to be converted to .json )
                     sounds/
+
                     audio/
 
     AUTHORS                        ( Should include names of everyone that has contributed to Karma main package )
 
     AUTHORS                        ( Should include names of everyone that has contributed to Karma main package )
     ChangeLog                     
+
     css/                          ( css/ and js/ contain the code common to all examples, lessons )
 
     COPYING                        ( Licensing information, should default to MIT License  ? how distinguish b/w code licensing and content licensing )
 
     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 )
+
     docs/
 
     examples/                      ( working examples of karma lessons )
 
     examples/                      ( working examples of karma lessons )
 +
    index.html                    ( The starting page for accessing Karma lessons, should include links to the examples, known as the CHAKRA )
 
     js/                            ( css/ and js/ contain the code common to all examples, lessons, and karma.html )
 
     js/                            ( css/ and js/ contain the code common to all examples, lessons, and karma.html )
    INSTALL                       
  −
    karma                          ( This is a shell script that launches utils/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 )
  −
    karmaplatz.html                ( The starting page for accessing Karma lessons, should include links to the examples )
  −
    lessons/                        ( this is the workspace for creating new Karma lessons )
  −
    NEWS                            ( List of important changes to this package indexed by version )
  −
    po/
   
     README
 
     README
     utils/                           ( The [http://www.narwhaljs.org/ narwhal] command-line interpreter for javascript and other utility scripts used by karma.js )
+
     tests/                         unit tests
          bin/
  −
          browser/                        ( An html5-capable browser that can be used to create sugar .xo bundle )
  −
          karma.js                        ( The main utility script for karma, all it dependencies live in utils/ )
  −
          packages/
  −
          tests/
      
== Karma XO bundle ==
 
== Karma XO bundle ==
Line 43: Line 31:  
* It is still undecided whether karma will default to using Browse which is based on Firefox or [http://dev.laptop.org/~bobbyp/surf/Surf-106.xo Surf] which based on webkit (Safari/Chrome). Surf requires that you install the rpms for pywebkitgtk and webkitgtk
 
* It is still undecided whether karma will default to using Browse which is based on Firefox or [http://dev.laptop.org/~bobbyp/surf/Surf-106.xo Surf] which based on webkit (Safari/Chrome). Surf requires that you install the rpms for pywebkitgtk and webkitgtk
    +
The '''Below information is out-of-date'''
 +
<strike>
 
   activity/
 
   activity/
 
         activity.info                          (activity info file)
 
         activity.info                          (activity info file)
Line 65: Line 55:  
   edittoolbar.py
 
   edittoolbar.py
 
   globalhistory.py
 
   globalhistory.py
 +
  icons
 +
  index.html
 
   js/
 
   js/
  icons
   
   linkbutton.py
 
   linkbutton.py
 
   karma
 
   karma
 
   karmaactivity.py
 
   karmaactivity.py
  karmaplatz.html
   
   lessons/
 
   lessons/
 
   locale
 
   locale
Line 88: Line 78:  
   utils/
 
   utils/
 
   webtoolbar.py
 
   webtoolbar.py
 +
</strike>
 +
== Lesson ==
   −
== Karma lesson bundle ==
+
''consists of a single lesson''
   −
''consists of multiple lesson in a single bundle''
+
  lesson_name/
 
  −
* common jquery and css files in a single folder
  −
* The '''karma''' utility script can be used to generate a lesson bundle with accompanying main menu and ''search'' (probably some sort of sitemap)
  −
 
  −
  bundle_name/
   
               assets/
 
               assets/
                       default/
+
                       {langCode}/         (files specific to langCode: en-US, en, es-MX, es, ....) and not the default locale
                              docs/
+
                      image/
                              images/
+
                      audio/
                              sounds/
+
                      svg/
                              default.po
+
                      video/
             
  −
              karmaplatz.html          ( Common gateway to access the lessons in the bundle)
  −
              css/                    ( common css files (e.g. jquery.jgrowl.css and menu.css ) )
  −
              js/                      ( common javascript / jquery files )
  −
              lessons/                 ( directory for all the lessons )
  −
                    lesson_name1/
  −
                    lesson_name2/
   
                
 
                
 +
              css/
 +
                    lesson.css
 +
              index.html           
 +
              js/
 +
                  lesson.js      main logic of program
 +
              kDoc.html  (viewer for lesson plan and teacher's Note)
 +
              lessonPlan.html
 +
              teachersNote.html
 +
              start.html    (start page)
 +
           
 +
 +
*Notes:
 +
# {langCode} represents the lang code and country code
 +
# which will be the template language for assets/docs/* ?, English suggested
 +
# suggestion: rename assets/{langCode}/docs/ to docs/{langCode}/ . This is based that at this moment there are no other kind of files under assets/ than 'docs'
   −
== Lesson ==
+
The following is out of date but kept for history
 +
<strike>
   −
''consists of a single lesson''
+
== Reading, Game and Exercise ==
 +
''consist of a single 'reading', 'game' or 'exercise' ''
   −
  lesson_name/
+
{type}/
               index.html              ( valid html5 -- markup only includes visual elements and links in other resources, no inline code or styling )
+
               index.html              (valid html5 -- markup only includes visual elements and links in other resources, no inline code or styling )
               css/lesson_name.css     ( css files  -- specific to the lesson )
+
               css/{type}.css           ( css files  -- specific to the lesson )
               js/ lesson_name.js       ( javascript controlling logic for the lesson )        
+
               js/{type}.js             ( javascript controlling logic for the lesson )
 
               po/                      ( translation files )
 
               po/                      ( translation files )
                   ne_NP.po            # example translation file for Nepal - Nepali
+
                   ne-NP.po            ( example translation file for Nepal - Nepali )
                   sp_ES.po            # example translation file for traditional Spanish
+
                   sp-ES.po            ( example translation file for traditional Spanish )
 +
                  {langCode}.po        ( translation file )
 
               assets/
 
               assets/
 +
                    generic/          ( for language independent assets (e.g. arrows, background images, etc.) )
 +
                        images/
 +
                            preview.jpg  ( screenshot for Chakra  )
 +
                        sounds/
 +
                        videos/
 +
                        docs/
 
                     ne/
 
                     ne/
 
                         images/
 
                         images/
 
                         sounds/
 
                         sounds/
 +
                        videos/
 
                         docs/
 
                         docs/
                            activity text
  −
                            lesson plan
  −
                            teachers note
   
                     en/
 
                     en/
 
                         images/
 
                         images/
 
                         sounds/
 
                         sounds/
 +
                        videos/
 +
                        docs/
 +
                    {langCode}/
 +
                        images/
 +
                        sounds/
 +
                        videos/
 
                         docs/
 
                         docs/
 +
* Notes
 +
# {type} represents 'game' or 'exercise' or 'reading'
 +
# does docs/ is used?
 +
</stike>
359

edits

Navigation menu