Activities/Learn: Difference between revisions

(6 intermediate revisions by 2 users not shown)

Line 12:

Learn is a component of the Karma Learning System. When installed as a part of KLS, it is tightly integrated with the schoolserver. The primary design goal is to provide local copies of lessons as needed so that the student can use them when not connected to the school server.

Version 51 enables evaluation of the activity independently of a schoolserver by using a USB removable drive.

Version 61 enables evaluation of the activity independently of a schoolserver by using a USB removable drive.

Line 27:

,you should see /media/XXX (where XXX is the label of your removable drive).

The Learn activity requires a recent (4+) version of Firefox. While Firefox is installed on versions of

On 12.0.1 and later releases use /run/media/olpc/XXX.

Sugar with the Gnome desktop, the version ~~precedes version 4~~.

Make sure the label XXX does not have spaces. A label such as /media/kls is fine. A label such as

/media/Store N Go does not work.

The Learn activity requires a recent (12+) version of Firefox. While Firefox is installed on versions of

Sugar with the Gnome desktop, the version doe not provide the needed capabilities.

From the Firefox website, download the compressed Firefox file, e.g. firefox-*.tar.bz2, where '*' is the

version number of the latest Firefox release, e.g. 13.0. Copy this file to the XXX drive.

version number of the latest Firefox release, e.g. 16.0. Copy this file to the XXX drive.

From this website download these files and copy them to the XXX drive:

[[~~Image~~:~~Kls_demo_1~~.tar.bz2]] is a ~~45mb~~ file which contains the sample content for the Learn activity

[[File:Kls_demo_2.tar.bz2]] is a 50mb file which contains the sample content kls and other files

for the Learn activity. Unpack it with the command:

~~[[File:Learn~~.~~sh]] is a script which installs Learn from the bundle~~.

tar -xvjf Kls_demo_2.tar.bz2

~~[[File:Firefox~~.~~sh]] is a script which installs Firefox from~~ the ~~tar~~ file ~~on the XXX drive. It also~~

This populates the drive with the scripts and the kls folder which contains the sample content. Optionally, delete the compressed file: Kls_demo_2.tar.bz2:

~~modifies two files in Sugar~~: ~~sugar-launch and SimpleHTTPServer~~.~~py. These changes have no effect on~~

~~normal Sugar use~~.

Download learn-51.xo from the Activities.Sugarlabs.org ~~site~~. Copy this bundle to the ~~XXX~~ drive.

rm -rf Kls_demo_2.tar.bz2

xo-custom is a script which sets up the XO to use the Learn.activity. It installs Firefox from the tar file on the XXX drive. It modifies two files in Sugar: sugar-launch and SimpleHTTPServer.py. Finally it sets up the XO to start the localhost daemon at boot. These changes do not affect normal operation of Sugar.

Download learn-61.xo from the activities.sugarlabs.org site. Copy this bundle to the XXX drive.

Download showntell-12.xo from the Activities.Sugarlabs.org. Copy this bundle to the xxx drive.

When this is done, the command: ls /media/XXX should show the following:

firefox-*.tar.bz2

~~Firefox.sh~~

kls

~~Kls_demo_1~~.tar.bz2

Kls_demo_2.tar.bz2

learn-51.xo

learn-61.xo

~~Learn~~.sh

localhost.service

rc.local

readme

showntell-12.xo

SimplerHTTPServer.py

sugar-launch

xo-custom

===Execute the install ~~scripts~~===

===Execute the install script===

Now mount the XXX drive on the XO.

Line 60:

Line 75:

Enter the commands:

cd /media/XXX

cd /media/XXX or cd /run/media/olpc/XXX

./~~Learn.sh~~

bash xo-custom

~~sudo ,/Firefox.sh~~

Upon completion of these commands, the script shuts down the XO.

Line 81:

Line 95:

In 'Tabs', uncheck 'Always show the tab bar'. Students do not normally use tabs in Firefox.

Students are advised to ~~set View to~~ fullscreen~~. Fortunately current versions of Firefox start in fullscrren~~

Customize the navigation toolbar. Add the full-screen icon. Choose small icons. In a deployment without internet, the Google icon can be removed.

~~when shut down in that mode. There is apparently no way to specify that Firefox launch in full screen~~ mode ~~and, currently, there is no way to access F11 on the XO (even in Gnome desktop!)~~.

Students are advised to use fullscreen mode.

Firefox tries to refresh pages from a cache in memory. This can sometimes prevent changes in screens to be immediately visible. In this case, use alt+F5 to refresh the page from the source. Note: on the XO keyboard,

Line 549:

Line 564:

The user needs to quit the launched activity when finished to return to the Learn activity. Sugar treats the launched activity as a window opened by Learn and so gets confused if the user tries to return to Learn via the frame.

~~==TinyMCE==~~

~~The editor (TinyMCE) provides an edit toolbar:~~

~~[[Image:tinymce_toolbar.png]]~~

~~The tool bar has three rows of tools divided into groups by a vertical bar '|'~~

~~The first group in the top row selects the font family: bold, italic, underline, .~~

~~The next group aligns the text: left, center, right, full (aligned both left and right).~~

~~The third group has two lists. The first lists the css classes defined in the global stylesheet.~~

~~It is not very useful in the editor. However, the second lists predefined text styles such as~~

~~'paragraph' - the default for body text and several forms for headings. Heading 1 is appropriate for a screen or activity title, heading 2 for subtitles.~~

~~In the second row, the first group selects a bulleted list (unordered) or a numbered list (ordered). The next group selects an outdent (move line left) and indent (move line right).~~

~~The next group selects undo (roll back the previous edit) or redo (undo the undo).~~

~~The last group in the second row has seven tools. These are not currently useful with the content editor.~~

In the first group of the third row, the first tool inserts a horizontal rule. This is used in Learn to identify a screen boundary. In the second group, the first tool selects a superscript mode. The second sets a subscript mode. The tool in the third group allows the insertion of a special character from a table of special characters.

~~===Special Formats===~~

~~Sometimes lessons need special formatting. This is provided in edit mode by the + icon. In learn-50 there are three special formats: normal (table), Placetable, and Problems.~~

~~The user obtains HTML formatting for a table by entering the number of columns and rows. The user can also specify a row of headers and provide the header titles.~~

The Placetable is a special form of table used in Mathematics lessons. In this case the columns headers give the column place value. The Placetable can be for whole numbers or up to three decimal places (0 decimal places for whole numbers).

The third option is to format arithmetic problems in column form. The user specifies the number of problems in that row (1-10). The problem is filled with the digit 9 so that the user can edit it to the needed values. Learn generates the problem with a monospace font so that the digits are aligned by place value.

==Integration in the Karma Learning System==

@@ Line 12: / Line 12: @@
 Learn is a component of the Karma Learning System. When installed as a part of KLS, it is tightly integrated with the schoolserver. The primary design goal is to provide local copies of lessons as needed so that the student can use them when not connected to the school server.
-Version 51 enables evaluation of the activity independently of a schoolserver by using a USB removable drive.
+Version 61 enables evaluation of the activity independently of a schoolserver by using a USB removable drive.
@@ Line 27: / Line 27: @@
 ,you should see /media/XXX (where XXX is the label of your removable drive).
-The Learn activity requires a recent (4+) version of Firefox. While Firefox is installed on versions of
+On 12.0.1 and later releases use /run/media/olpc/XXX.
-Sugar with the Gnome desktop, the version precedes version 4.
+Make sure the label XXX does not have spaces. A label such as /media/kls is fine. A label such as
+/media/Store N Go does not work.
+The Learn activity requires a recent (12+) version of Firefox. While Firefox is installed on versions of
+Sugar with the Gnome desktop, the version doe not provide the needed capabilities.
 From the Firefox website, download the compressed Firefox file, e.g. firefox-*.tar.bz2, where '*' is the
-version number of the latest Firefox release, e.g. 13.0. Copy this file to the XXX drive.
+version number of the latest Firefox release, e.g. 16.0. Copy this file to the XXX drive.
 From this website download these files and copy them to the XXX drive:
-[[Image:Kls_demo_1.tar.bz2]] is a 45mb file which contains the sample content for the Learn activity
+[[File:Kls_demo_2.tar.bz2]] is a 50mb file which contains the sample content kls and other files
+for the Learn activity. Unpack it with the command:
-[[File:Learn.sh]] is a script which installs Learn from the bundle.
+tar -xvjf Kls_demo_2.tar.bz2
-[[File:Firefox.sh]] is a script which installs Firefox from the tar file on the XXX drive. It also
+This populates the drive with the scripts and the kls folder which contains the sample content. Optionally, delete the compressed file: Kls_demo_2.tar.bz2:
-modifies two files in Sugar: sugar-launch and SimpleHTTPServer.py. These changes have no effect on
-normal Sugar use.
-Download learn-51.xo from the Activities.Sugarlabs.org site. Copy this bundle to the XXX drive.
+rm -rf Kls_demo_2.tar.bz2
+xo-custom is a script which sets up the XO to use the Learn.activity. It installs Firefox from the tar file on the XXX drive. It  modifies two files in Sugar: sugar-launch and SimpleHTTPServer.py. Finally it sets up the XO to start the localhost daemon at boot. These changes do not affect normal operation of Sugar.
+Download learn-61.xo from the activities.sugarlabs.org site. Copy this bundle to the XXX drive.
+Download showntell-12.xo from the Activities.Sugarlabs.org. Copy this bundle to the xxx drive.
 When this is done, the command: ls /media/XXX should show the following:
   firefox-*.tar.bz2
-  Firefox.sh
+  kls
-  Kls_demo_1.tar.bz2
+  Kls_demo_2.tar.bz2
-  learn-51.xo
+  learn-61.xo
-  Learn.sh
+  localhost.service
+ rc.local
+ readme
+ showntell-12.xo
+ SimplerHTTPServer.py
+ sugar-launch
+ xo-custom
-===Execute the install scripts===
+===Execute the install script===
 Now mount the XXX drive on the XO.
@@ Line 60: / Line 75: @@
 Enter the commands:
-  cd /media/XXX
+  cd /media/XXX or cd /run/media/olpc/XXX
- ./Learn.sh
+  bash xo-custom
-  sudo ,/Firefox.sh
 Upon completion of these commands, the script shuts down the XO.
@@ Line 81: / Line 95: @@
 In 'Tabs', uncheck 'Always show the tab bar'. Students do not normally use tabs in Firefox.
-Students are advised to set View to fullscreen. Fortunately current versions of Firefox start in fullscrren
+Customize the navigation toolbar. Add the full-screen icon. Choose small icons. In a deployment without internet, the Google icon can be removed.
-when shut down in that mode. There is apparently no way to specify that Firefox launch in full screen mode and, currently, there is no way to access F11 on the XO (even in Gnome desktop!).
+Students are advised to use fullscreen mode.
 Firefox tries to refresh pages from a cache in memory. This can sometimes prevent changes in screens to be immediately visible. In this case, use alt+F5 to refresh the page from the source. Note: on the XO keyboard,
@@ Line 549: / Line 564: @@
 The user needs to quit the launched activity when finished to return to the Learn activity. Sugar treats the launched activity as a window opened by Learn and so gets confused if the user tries to return to Learn via the frame.
-==TinyMCE==
-The editor (TinyMCE) provides an edit toolbar:
-[[Image:tinymce_toolbar.png]]
-The tool bar has three rows of tools divided into groups by a vertical bar '|'
-The first group in the top row selects the font family: bold, italic, underline,  .
-The next group aligns the text: left, center, right, full (aligned both left and right).
-The third group has two lists. The first lists the css classes defined in the global stylesheet.
-It is not very useful in the editor. However, the second lists predefined text styles such as
-'paragraph' - the default for body text and several forms for headings. Heading 1 is appropriate for a screen or activity title, heading 2 for subtitles.
-In the second row, the first group selects a bulleted list (unordered) or a numbered list (ordered). The next group selects an outdent (move line left) and indent (move line right).
-The next group selects undo (roll back the previous edit) or redo (undo the undo).
-The last group in the second row has seven tools. These are not currently useful with the content editor.
-In the first group of the third row, the first tool inserts a horizontal rule. This is used in Learn to identify a screen boundary. In the second group, the first tool selects a superscript mode. The second sets a subscript mode. The tool in the third group allows the insertion of a special character from a table of special characters.
-===Special Formats===
-Sometimes lessons need special formatting. This is provided in edit mode by the + icon. In learn-50 there are three special formats: normal (table), Placetable, and Problems.
-The user obtains HTML formatting for a table by entering the number of columns and rows. The user can also specify a row of headers and provide the header titles.
-The Placetable is a special form of table used in Mathematics lessons. In this case the columns headers give the column place value. The Placetable can be for whole numbers or up to three decimal places (0 decimal places for whole numbers).
-The third option is to format arithmetic problems in column form. The user specifies the number of problems in that row (1-10). The problem is filled with the digit 9 so that the user can edit it to the needed values. Learn generates the problem with a monospace font so that the digits are aligned by place value.
 ==Integration in the Karma Learning System==