Moved the help files into their own directory in lang/en/help

diff --git a/lang/en/help/courseformats.html b/lang/en/help/courseformats.html
new file mode 100644 (file)
index 0000000..2cc26c4
--- /dev/null
+++ b/lang/en/help/courseformats.html
@@ -0,0 +1,24 @@
+<P ALIGN=CENTER><B>Moodle course formats</B></P>
+
+<P><B>Weekly format</B></P>
+<UL>
+The course is organised week by week, with a clear start date and a finish date.
+Each week consists of activities.  Some of them, like journals, may have 
+"open windows" of, say, two weeks after which they become unavailable.
+</UL>
+
+<P><B>Topics format</B></P>
+<UL>
+Very similar to the weekly format, except that each "week" is called a topic.
+A "topic" is not restricted to any time limit.  You don't need to specify any
+dates.
+</UL>
+
+<P><B>Social format</B></P>
+<UL>
+This format is oriented around one main forum, the Social forum, which appears
+listed on the main page.  It is useful for situations that are more freeform.
+They may not even be courses.  For example, it could be used as a departmental
+notice board.
+</UL>
+

diff --git a/lang/en/help/picture.html b/lang/en/help/picture.html
new file mode 100644 (file)
index 0000000..026cfcb
--- /dev/null
+++ b/lang/en/help/picture.html
@@ -0,0 +1,17 @@
+<P ALIGN=CENTER><B>Uploading a picture</B></P>
+
+<P>You can upload a picture from your computer to this server, and this picture will be used in various places to represent you.
+<P>For this reason, the best images to use are a close-up of your face, but you can use any image you like.
+<P>The picture must be in JPG or PNG format (ie the names will usually end in .jpg or .png).
+<P>You can get a picture file using one of four methods:
+
+<OL>
+<LI>Using a digital camera, your photos will most likely already be on your computer in the right format.
+<LI>You can use a scanner to scan a printed photograph.  Make sure you save it as JPG or PNG format.
+<LI>If you're artistic, you might draw a picture using a paint program.
+<LI>Lastly, you can "steal" images from the web.  <A TARGET=google HREF="http://images.google.com/">http://images.google.com</A> is a superb place to search for images. Once you find one, you can "right-click" on them with the mouse and choose "Save this image..." from the menu (different computers may vary slightly).
+</OL>
+
+<P>To upload the image, click the "Browse" button on this editing page, and select the image from your hard disk.
+<P>Then click "Update my Profile" at the bottom - the image file will be cropped to a square and resized down to 100x100 pixels.
+<P>When you are taken back to your profile page, the image might not appear to have changed.  If this is so, just use the "Reload" button in your browser.

diff --git a/lang/en/help/questions.html b/lang/en/help/questions.html
new file mode 100644 (file)
index 0000000..d96e3e1
--- /dev/null
+++ b/lang/en/help/questions.html
@@ -0,0 +1,94 @@
+<h2>Asking questions</h2>\r
+<p>Socratic questions are open-ended, probing questions designed to promote critical \r
+  evaluation of ideas, as well as encourage the creation of new ideas. Below are \r
+  some examples of such questions:</p>\r
+<h3>Questions of Clarification</h3>\r
+<ul>\r
+  <li>What do you mean by ____?</li>\r
+  <li>What is your main point?</li>\r
+  <li>How does _____ relate to _____?</li>\r
+  <li>Could you put that another way?</li>\r
+  <li>Is your basic point _____ or _____?</li>\r
+  <li>What do you think is the main issue here?</li>\r
+  <li>Let me see if I understand you; do you mean _____ or _____?</li>\r
+  <li>How does this relate to our problem/discussion/issue?</li>\r
+  <li>What do you, Mike, mean by this remark? What do you take Mike to mean by \r
+    his remark?</li>\r
+  <li>Jane, can you summarize in your own words what Richard said? . . . Richard, \r
+    is this what you meant?</li>\r
+  <li>Could you give me an example?</li>\r
+  <li>Would this be an example, . . .?</li>\r
+  <li>Could you explain this further?</li>\r
+  <li>Would you say more about that?</li>\r
+  <li>Why do you say that?</li>\r
+</ul>\r
+<h3>Questions that probe assumptions</h3>\r
+<ul>\r
+  <li>What are you assuming?</li>\r
+  <li>What is Jenny assuming?</li>\r
+  <li>What could we assume instead?</li>\r
+  <li>You seem to be assuming _____. Do I understand you correctly?</li>\r
+  <li>All of your reasoning depends on the idea that _____. Why have you based \r
+    your reasoning on _____ instead of _____?</li>\r
+  <li>You seem to be assuming _____. How do you justify taking that for granted?</li>\r
+  <li>Is that always the case? Why do you think the assumption holds here?</li>\r
+  <li>Why would someone make that assumption? </li>\r
+</ul>\r
+<h3>Questions that probe reasons and evidence</h3>\r
+<ul>\r
+  <li>What would be an example?</li>\r
+  <li>How do you know?</li>\r
+  <li>Why do you think that is true?</li>\r
+  <li>Do you have any evidence for that?</li>\r
+  <li>What difference does that make?</li>\r
+  <li>What are your reasons for saying that?</li>\r
+  <li>What other information do you need?</li>\r
+  <li>Could you explain your reasons to us?</li>\r
+  <li>Are these reasons adequate?</li>\r
+  <li>Why do you say that?</li>\r
+  <li>What led you to that belief?</li>\r
+  <li>How does that apply to this case?</li>\r
+  <li>What would change your mind?</li>\r
+  <li>But, is that good evidence for that belief?</li>\r
+  <li>Is there a reason to doubt that evidence?</li>\r
+  <li>Who is in a position to know that is true?</li>\r
+  <li>What would you say to someone who said that ____?</li>\r
+  <li>Can someone else give evidence to support that view?</li>\r
+  <li>By what reasoning did you come to that conclusion?</li>\r
+  <li>How could we find out if that is true? </li>\r
+</ul>\r
+<h3>Questions about Viewpoints or Perspectives </h3>\r
+<ul>\r
+  <li>The term &quot;imply&quot; will require clarification when used with younger \r
+    students.</li>\r
+  <li>What are you implying by that?</li>\r
+  <li>When you say _____, are you implying _____?</li>\r
+  <li>But, if that happened, what else would happen as a result? Why?</li>\r
+  <li>What effect would that have?</li>\r
+  <li>Would that necessarily happen or only possibly/probably happen?</li>\r
+  <li>What is an alternative?</li>\r
+  <li>If _____ and _____ are the case, then what might also be true?</li>\r
+  <li>If we say that ____ is ethical, how about _____? </li>\r
+</ul>\r
+<h3>Questions that Probe Implications and Consequences </h3>\r
+<ul>\r
+  <li>How can we find out?</li>\r
+  <li>What does this question assume?</li>\r
+  <li>Would _____ ask this question differently?</li>\r
+  <li>How could someone settle this question?</li>\r
+  <li>Can we break this question down at all?</li>\r
+  <li>Is this question clear? Do we understand it?</li>\r
+  <li>Is this question easy or hard to answer? Why?</li>\r
+  <li>Does this question ask us to evaluate something? What?</li>\r
+  <li>Do we all agree that this is the question?</li>\r
+  <li>To answer this question, what other questions must we answer first?</li>\r
+  <li>I'm not sure I understand how you are interpreting this question. Is this \r
+    the same as _____?</li>\r
+  <li>How would _____ state the issue?</li>\r
+  <li>Why is this issue important?</li>\r
+  <li>Is this the most important question, or is there an underlying question \r
+    that is really the issue? </li>\r
+</ul>\r
+\r
+<HR>\r
+<FONT SIZE=1><I>Questions adapted from Paul, R. (1993). Critical Thinking: How To Prepare Students for a Rapidly Changing World: Foundation for Critical Thinking, Santa Rosa, CA. </I></FONT>\r

diff --git a/lang/en/help/text.html b/lang/en/help/text.html
new file mode 100644 (file)
index 0000000..eb48fda
--- /dev/null
+++ b/lang/en/help/text.html
@@ -0,0 +1,41 @@
+<P ALIGN=CENTER><B>Help on writing text</B></P>
+
+Writing text in Moodle works pretty much the way you would expect, but you also have the ability to include "smilies", "URL addresses" and some HTML tags in your text.
+
+<P><B>Smilies (emoticons)</B></P>
+<UL>
+<TABLE BORDER=0 CELLPADDING=5 CELLSPACING=5>
+<TR><TH>Name       <TH>Picture                                                 <TH>You type</TR>
+<TR><TD>smile      <TD ALIGN=CENTER><img ALT=smile SRC="<?=$CFG->wwwroot?>/pix/s/smiley.gif"><TD ALIGN=CENTER> :-) </TD></TR>
+<TR><TD>sad        <TD ALIGN=CENTER><img ALT=sad SRC="<?=$CFG->wwwroot?>/pix/s/sad.gif"><TD ALIGN=CENTER> :-( </TD></TR>
+<TR><TD>grin       <TD ALIGN=CENTER><img ALT=grin SRC="<?=$CFG->wwwroot?>/pix/s/biggrin.gif"><TD ALIGN=CENTER> :-D </TD></TR>
+<TR><TD>wink       <TD ALIGN=CENTER><img ALT=wink SRC="<?=$CFG->wwwroot?>/pix/s/wink.gif"><TD ALIGN=CENTER> ;-) </TD></TR>
+<TR><TD>mixed      <TD ALIGN=CENTER><img ALT=mixed SRC="<?=$CFG->wwwroot?>/pix/s/mixed.gif"><TD ALIGN=CENTER> :-/ </TD></TR>
+<TR><TD>wide-eyed  <TD ALIGN=CENTER><img ALT=wide-eyed SRC="<?=$CFG->wwwroot?>/pix/s/wideeyes.gif"><TD ALIGN=CENTER> 8-) </TD></TR>
+<TR><TD>tongue-out <TD ALIGN=CENTER><img ALT=tongue-out SRC="<?=$CFG->wwwroot?>/pix/s/tongueout.gif"><TD ALIGN=CENTER> :-P </TD></TR>
+<TR><TD>surprise   <TD ALIGN=CENTER><img ALT=surprised SRC="<?=$CFG->wwwroot?>/pix/s/surprise.gif"><TD ALIGN=CENTER> :-o </TD></TR>
+<TR><TD>cool       <TD ALIGN=CENTER><img ALT=cool SRC="<?=$CFG->wwwroot?>/pix/s/cool.gif"><TD ALIGN=CENTER> B-) </TD></TR>
+</TABLE>
+</UL>
+
+<P><B>URLs</B></P>
+<UL>
+<P>Any "word" starting with <B>www.</B> or <B>http://</B> will automatically be turned into a clickable link. 
+<P>For example:  <A HREF="http://www.yahoo.com">www.yahoo.com</A> or <A HREF="http://curtin.edu">http://curtin.edu</A>
+</UL>
+
+<P><B>HTML tags</B></P>
+<UL>
+<P>You can use a limited subset of HTML tags to add emphasis to your texts.
+<TABLE BORDER=0 CELLPADDING=5 CELLSPACING=5>
+<TR><TH>HTML tags<TH>Produces</TR>
+<TR><TD>&lt;B> bold &lt;/B> <TD> <B>bold text</B> </TR>
+<TR><TD>&lt;I> italic &lt;/I> <TD> <I>italic text</I> </TR>
+<TR><TD>&lt;U> underline &lt;/U> <TD> <U>underlined text</U> </TR>
+<TR><TD>&lt;FONT SIZE=1> small &lt;/FONT> <TD> <FONT SIZE=1>small</FONT> </TR>
+<TR><TD>&lt;FONT SIZE=4> large &lt;/FONT> <TD> <FONT SIZE=4>large</FONT> </TR>
+<TR><TD>&lt;FONT COLOR=green> example &lt;/FONT> <TD> <FONT color=green>example</FONT> </TR>
+</TABLE>
+</UL>
+
+

diff --git a/lang/en/moodle.php b/lang/en/moodle.php
index ffe6260e57a3632157c4be7f71ca0323e0be6424..17ca400f5f0faa4f8d798701a70a9311b9470024 100644 (file)
--- a/lang/en/moodle.php
+++ b/lang/en/moodle.php
@@ -31,6 +31,7 @@ $string[complete] = "Complete";
 $string["continue"] = "Continue";
 $string[country] = "Country";
 $string[course] = "Course";
+$string[courseformats] = "Course formats";
 $string[courses] = "Courses";
 $string[createaccount] = "Create my new account";
 $string[createuserandpass] = "Create a new username and password to log in with";
@@ -52,6 +53,7 @@ $string[description] = "Description";
 $string[edit] = "Edit \$a";
 $string[editcoursesettings] = "Edit course settings";
 $string[editmyprofile] = "Edit profile";
+$string[editsummary] = "Edit summary";
 $string[editthisactivity] = "Edit this activity";
 $string[edituser] = "Edit user accounts";
 $string[email] = "Email address";
@@ -94,6 +96,9 @@ $string[firstname] = "First name";
 $string[firsttime] = "Is this your first time here?";
 $string[forgotten] = "Forgotten your username or password?";
 $string[format] = "Format";
+$string[formatsocial] = "Social format";
+$string[formattopics] = "Topics format";
+$string[formatweeks] = "Weekly format";
 $string[fulllistofcourses] = "Full list of courses";
 $string[fullprofile] = "Full profile";
 $string[fullname] = "Full name";
@@ -166,6 +171,9 @@ $string[missingusername] = "Missing username";
 $string[movedown] = "Move down";
 $string[moveup] = "Move up";
 $string[mustconfirm] = "You need to confirm your login";
+$string[namesocial] = "section";
+$string[nametopics] = "topic";
+$string[nameweeks] = "week";
 $string[newaccount] = "New account";
 $string[newforumposts] = "New forum posts";
 $string[newpassword] = "New password";

diff --git a/lib/moodlelib.php b/lib/moodlelib.php
index b3915812eb971f7fb7da0670cc16962eb16c304f..90c9b81567e4d6e4a4b93ad94cdf90aa29bc6f50 100644 (file)
--- a/lib/moodlelib.php
+++ b/lib/moodlelib.php
@@ -449,7 +449,7 @@ function helpbutton ($page, $title="", $module="moodle", $image=true, $text="")
     if ($text) {
         $url = "/help.php?module=$module&text=$text";
     } else {
-        $url = "/help.php?module=$module&file=help.$page.php";
+        $url = "/help.php?module=$module&file=$page.html";
     }
     link_to_popup_window ($url, "popup", $linkobject, 400, 500, $title);
 }