184
edits
Changes
Jump to navigation
Jump to search
Line 12:
Line 12: − + Line 27:
Line 27: − + − + + + + + + − + − + + − [[File:Learn.sh]] is a script which installs Learn from the bundle.+ − [[File:Firefox.sh]] is a script which installs Firefox from the tar file on the XXX drive. It also + − modifies two files in Sugar: sugar-launch and SimpleHTTPServer.py. These changes have no effect on − normal Sugar use. − + + + + + + − Firefox.sh + − Kls_demo_1.tar.bz2 + − + − Learn.sh + + + + + + + − + Line 60:
Line 75: − + − ./Learn.sh+ − sudo ,/Firefox.sh Line 81:
Line 95: − + − 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!).+ + Line 450:
Line 465: − + − The Learn activity is part of the Karma Learning System.{T}+ − The OLPC laptop is often referred to by two letters. What are they? {=XO =xo}+ − There {=are} many people world-wide supporting the OLPC project. [is are]+ − One of these organizations is not related to the others. Which one? {=CIA ~OLPC ~Sugarlabs ~Red Hat}+ − + Line 549:
Line 564: − − ==Update== − − [[Image:example_activity.png]] − − The teacher creates or modifies lessons (activities) using the edit button on the header of the activity page. − This button loads the lesson into an editor (based on tinymce). − − The content editor enables the user to create or modify a lesson. The lesson − is an HTML web page. The editor (tinymce) fenables the content to be edited as − plain text. Some patience is required because the editor is going from plain text to − HTML modes character-by-character. − − ===Uploading Milestones=== − − The buttons (edit and up arrow) on the right of the header are used in creating lessons. Learn downloads milestones as a single zipped file. Learn also provides for modified milestones to be uploaded to the school server. − − If the up arrow is clicked in a milestone (activity ladder), the milestone will be packed and uploaded to the schoolserver. For learn-50, this can also be done using a USB flash drive in lieu of the school server. Mount a flash drive with a folder 'kls' at the root level. Learn will use this folder for uploads and downloads. For example, a milestone could be created with several activities (e.g. in Laboratory) and then uploaded by the up-arrow. The flash drive could be unmounted and moved to another laptop. On that laptop the milestone can be downloaded (click on the milestone which now has a light blue cap). − − Note that Learn has only been tested and is only supported on OLPC laptops at present. Learn is best used with a recent build of the software (e.g. 11.2). − − ===Examples=== − − The first milestone in Explore/examples has five activities which illustrate the capabilities of basic lessons which can be created by educators with limited computer experience. The examples in the other milestonse require intervention by someone familiar with the Linux and with using the Terminal activity. − − The first example is straight text. Such an activity is often used at the beginning of a milestone to introduce its topic. − − The second example is a text illustrated by an image. In the edit mode, an image may be added using the camera icon. The camera icon shows all of the images in the Documents folder (/home/olpc/Documents). This folder is made visible in the Journal activity of recent builds of the XO software. Images may be created with the Record activity or as sreenshots (ALT+1). It is wise to give each image a meaningful title as it is added to the Journal. Try to make the title with no spaces (e.g. use a hyphen or underscore or period instead. The best choice is the underscore because the hyphen and period may have special uses. Images may also be created using Sugar activities such as Paint. The image may be copied from the Journal to the Documents folder. Images taken with a mobile phone or digital camera may be copied to the Documents folder from a flash drive. It is often useful to make a diagram on paper and then photograph the paper. Make sure the paper is flat and well lit. A picture of a lesson on a blackboard can also be easily added to a Learn activity. − − In the edit mode, there is a camera icon at the top right of the screen. Clicking on this icon shows a screen with thumbnails of the images in the Documents folder. The user selects the correct image for the activity. The user is asked to specify the width and height of the image. The width of the screen is 1200 pixels so a width of 600 will occupy half of the screen. Images are often in a ration of 4:3 so that an image with a width of 600 would have a height of 450. In addition, the user is asked on which screen the image should appear. Finally, the user may specify the image as right or left. An image will appear at the top of the screen to the right or left with text flowing around it. If neither right or left is specified, the image will be centered at the top and the text will begin below the iamge. When the lesson is saved, the Learn activity makes a copy of the image in the activity folder resized to the specification. It adds code which will show the image on the screen. The user clicks on the save icon and then the left arrow to leave the edit mode. The iamge will now be visible in the lesson. − − The third example shows a multi-screen lesson. Using scrolling on an XO is awkward at best. It is better to divide a lesson into multiple screens (pages) to prevent the need for scrolling. The Learn activity provides navigation buttons at the bottom of the screen which make it easy for students to move from one screen to the next. The lesson needs to be divided at logical points. This is accomplished by moving the cursor immediately to the left of the first character of the next screen and inserting a 'horizontal rule' using the first tool on the third row of the editor's toolbar. − − The fourth example shows a lesson with an image and an audio track. The track can be pre-recorded as in the British Council story or can be recorded by the lesson author. The recording can be made using Record although − the microphone amplification of the XO is often insufficient. It can also be made by an external microphone using Record or using an external voice recorder. As with an image, the clip is copied from the Journal or an external flash drive to the Documents folder. Clicking on the microphone icon at the top of the edit screen shows all of the audio clips in the Documents folder. The user selects the correct clip for the activity. When the lesson is saved, the Learn activity will add the clip to the lesson. − − When a student does the activity, there will be a play button on the bottom right of the screen. When clicked the audio clip will play and a pause button will be shown. When the pause button is clicked, the playback stops and the play button is shown. The playback continues independently of the screen shown. The British Council story, for example, allows the student to read the story advancing to the next page in time with the audio track. − − The fifth example shows a lesson which includes a quiz. The quiz is entered in a special format developed by Moodle called 'gift'. In edit mode, the lesson may show special comments framed by '/*' and '*/'. The quiz is entered in this form. − − The questions are entered between the following lines: − − /*Quiz − questions go here − */ − − The word Quiz (capitol Q) must be entered after /* with no spaces. − The '*/' is on a separate line. The questions are entered between these two lines separated by a blank line. − Here are some example questions: − − /*Quiz − The Learn activity is part of the Karma Learning System.{T} − − The OLPC laptop is often referred to by two letters. What are they? {=XO =xo} − − There {=are} many people world-wide supporting the OLPC project. [is are] − − One of these organizations is not related to the others. Which one? {=CIA ~OLPC ~Sugarlabs ~Red Hat} − */ − − The first question is True-False. Answers are shown between braces '{ }'. The answer to a True-False question may be any of T, t, True, true, F, f, False, false. Note that, unlike the othere answers, an equal sign '=' is not needed. − − The second question is short answer. Acceptable answers (one or more) are given between braces. In this case, XO and xo will be accepted as correct. Xo and xO would be considered incorrect. − − The third question is a cloze. It is identical to the short answer except the braces are within the text. The student will see a blank (underlines) where the braces are entered along with a place to enter the answer. − − The fourth question is multiple-choice. The choices are given between braces. The correct answer is indicated by the equal sign '='. The incorrect choices (distractors) are indicated by the tilde sign '~'. − − The quiz is created when the lesson is saved. When the student opens the lesson, there will be a 'Start' button shown on the bottom right of the screen. The screen gives information (e.g. a diagram) needed to answer the questions and/or instructions on answering the questions (e.g. round your answer to two decimal places). − − When the student presses the Start button, he is given the questions one at a time in the order they appear in the lesson (not randomized). − − ===Using Sugar Activities=== − − A lesson may launch a Sugar activity. This is accomplished by entering a special comment as follows: − − /*B:ShowNTell,lines.cpxo,application/x-classroompresenter*/ − − The comment must be on a single line (word wrap to more than one line is ok). It must start with /*B: and finish with */. Spaces are not allowed. There are three parameters separated by commas. The first is the name of the activity: ShowNTell. Do not include the word activity. Use Turtleart but not Turtle Art or Turtleart.activity. − The second parameter is tha name of a bundle to be associated with the activity at launch. The third parameter is the mime-type of the bundle. − − A comment such as /*B:Write*/ would result in a launching the Write activity as a new start. − − The specified bundles must be in the activity folder. At present there is no automated procedure to create bundles (normally done using the activity itself), nor to copy the bundle to the activity folder. This can be done using the Terminal activity (command line). − − In learn-51, this capability will be extended to 'templates'. A template is a Sugar activity or Karma library animation which can be included in an activity with special content entered as a comment. For example, an activity could launch the Wordsearch activity with a specific wordlist. This might appear as follows: − − /*B:Wordsearch,vocab.txt,text/plain − head − foot − finger − chest − shoulder − throat − leg − */ − − Notice that the entry is the same as that for launching a Sugar activity except that word list is entered between the /* and the */ which are now on separate lines. The first line must have the parameters. The wordlist starts on the next line. The '*/' must be on a line by itself. − − In learn-51 it will therefore be possible to use Sugar activities or templates without the need for using the Terminal activity (command-line). − − ==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. −
→Prepare a removable drive
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.
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.
,you should see /media/XXX (where XXX is the label of your removable drive).
,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
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:
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:
tar -xvjf Kls_demo_2.tar.bz2
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:
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:
When this is done, the command: ls /media/XXX should show the following:
firefox-*.tar.bz2
firefox-*.tar.bz2
kls
Kls_demo_2.tar.bz2
learn-51.xo
learn-61.xo
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.
Now mount the XXX drive on the XO.
Enter the commands:
Enter the commands:
cd /media/XXX
cd /media/XXX or cd /run/media/olpc/XXX
bash xo-custom
Upon completion of these commands, the script shuts down the XO.
Upon completion of these commands, the script shuts down the XO.
In 'Tabs', uncheck 'Always show the tab bar'. Students do not normally use tabs in Firefox.
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.
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,
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,
The word Quiz (capitol Q) must be entered after /* with no spaces. The '*/' is on a separate line. The questions are entered between these two lines separated by a blank line. Here are some example questions:
The word Quiz (capitol Q) must be entered after /* with no spaces. The '*/' is on a separate line. The questions are entered between these two lines separated by a blank line. Here are some example questions:
<pre>
/*Quiz
/*Quiz
The Learn activity is part of the Karma Learning System.{T}
The OLPC laptop is often referred to by two letters. What are they? {=XO =xo}
There {=are} many people world-wide supporting the OLPC project. [is are]
One of these organizations is not related to the others. Which one? {=CIA ~OLPC ~Sugarlabs ~Red Hat}
*/
*/
</pre>
The first question is True-False. Answers are shown between braces '{ }'. The answer to a True-False question may be any of T, t, True, true, F, f, False, false. Note that, unlike the other answers, an equal sign '=' is not needed.
The first question is True-False. Answers are shown between braces '{ }'. The answer to a True-False question may be any of T, t, True, true, F, f, False, false. Note that, unlike the other answers, an equal sign '=' is not needed.
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.
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.
==Integration in the Karma Learning System==
==Integration in the Karma Learning System==