Cleaned up, with additions
authormoodler <moodler>
Sat, 26 Apr 2003 05:24:07 +0000 (05:24 +0000)
committermoodler <moodler>
Sat, 26 Apr 2003 05:24:07 +0000 (05:24 +0000)
lang/en/docs/faq.html

index 9cb1de5282e4da15ab19912b75cfd36bda998d52..af9a7fd69a8287b952547ea07bceba369000b0e4 100644 (file)
-<HEAD>\r
-    <TITLE>Moodle Docs: Frequently Asked Questions (FAQ)</TITLE>\r
-       <LINK REL="stylesheet" HREF="../theme/standard/styles.php" TYPE="TEXT/CSS">\r
-    <meta HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">\r
-</HEAD>\r
+<head>\r
+<title>Moodle Docs: Frequently Asked Questions (FAQ)</title>\r
+<link rel="stylesheet" href="../theme/standard/styles.php" type="TEXT/CSS">\r
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">\r
+<style type="text/css">\r
+<!--\r
+.question {\r
+       font-size: medium;\r
+       font-weight: bold;\r
+       font-family: "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif;\r
+       border: 1px dotted;\r
+       padding: 10px;\r
+       background-color: #EEEEEE;\r
+}\r
+.answer {\r
+       font-family: "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif;\r
+       font-size: medium;\r
+       border: none;\r
+       padding-left: 40px;\r
+}\r
+-->\r
+</style>\r
+<style type="text/css">\r
+<!--\r
+.normaltext {\r
+       font-family: "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif;\r
+       font-size: medium;\r
+       border: none;\r
+       padding-left: 10px;\r
+}\r
+-->\r
+</style>\r
+</head>\r
 \r
-<BODY BGCOLOR="#FFFFFF">\r
+<body bgcolor="#FFFFFF">\r
 <h2>Frequently Asked Questions (FAQ)</h2>\r
-<p>This page contains some of the most frequently asked questions with their\r
-   answers.  If you have a problem it may be quickest to check this page first.</p>\r
-\r
+<p class="normaltext">This page contains some of the most frequently asked questions \r
+  with their answers. If you have a problem it may be quickest to check this page \r
+  first.</p>\r
+<p class="normaltext">If you don't find the answer here try the <a href="http://moodle.org/mod/forum/index.php?id=5">Using \r
+  Moodle</a> course on moodle.org, and search the forums for keywords. You may \r
+  have to try a few different search phrases before you find a resolution.</p>\r
+<p class="normaltext">If you still can't find any answers try posting your question \r
+  on the appropriate forum in <a href="http://moodle.org/mod/forum/index.php?id=5">Using \r
+  Moodle</a> - someone should be able to help you.</p>\r
+<h2>Installation problems</h2>\r
+<p class="normaltext"><a href="#php">PHP - is it installed and what version do \r
+  I have?</a></p>\r
+<p class="normaltext"><a href="#blankpages">Why are all my pages blank?</a> </p>\r
+<p class="normaltext"><a href="#errorgetstring">My pages show fatal errors such \r
+  as : call to undefined function: get_string()</a></p>\r
+<p class="normaltext"><a href="#headerssent">Why do I keep getting error messages \r
+  about &quot;headers already sent&quot;?</a></p>\r
+<p class="normaltext"><a href="#failedopen">I keep getting this error: Failed \r
+  opening required '/web/moodle/lib/setup.php'</a></p>\r
+<p>&nbsp;</p>\r
+<h2>General problems</h2>\r
+<p class="normaltext"><a href="#filenotfound">Whenever I try to access or view \r
+  a file that I uploaded, I get an error &quot;File not Found&quot;</a></p>\r
 <hr>\r
-<h3>Cannot access uploaded files</h3>\r
-<blockquote>\r
-<p><b>Question:</b>  I have a strange problem with my new installation of Moodle. Whenever I try \r
-to access or view an uploaded resource, whether in the "Files" menu or on the course page, \r
-I get a 404 error like this one:\r
-<blockquote>\r
-Not Found<br>\r
-The requested URL /moodle/file.php/2/myfile.jpg was not found on this server. \r
+<h2>Installation problems</h2>\r
+<p class="normaltext">Most questions people have are related to installation, and most of these are \r
+  related to the editing of config.php file. Following the <a href="http://moodle.org/doc/?file=install.html">installation \r
+  instructions</a> carefully will usually result in a perfectly working system. \r
+  Here are some of the most common problems that are encountered:</p>\r
+<p>&nbsp;</p>\r
+<h4 class="question"><a name="php"></a>PHP - is it installed and what version \r
+  do I have?</h4>\r
+<div class="answer"> \r
+  <p>Make a new file on your web site called info.php, containing the following \r
+    text, and call it from your browser:</p>\r
+    \r
+  <pre>      &lt;?PHP phpinfo() ?&gt;</pre>\r
+</div>\r
+<p class="answer">If nothing happens then you don't have PHP installed. See the \r
+  installation docs for some information about where to download it for your computer.</p>\r
+<h4 class="question"><a name="blankpages"></a>Why are all my pages blank? </h4> \r
+<p class="answer">Check the dirroot and/or dataroot in config.php. You must use \r
+  complete, absolute pathnames:</p>\r
+<p class="answer"> eg &nbsp$CFG->dirroot = "d:\inetpub\sites\www.yoursite.com\web\moodle";</p>\r
+<p class="answer"> eg&nbsp $CFG->dataroot = "d:\inetpub\sites\www.yoursite.com\database\moodle";</p>\r
+<p>&nbsp; </p>\r
+<h4 class="question"><a name="errorgetstring"></a>My pages show fatal errors such \r
+  as : call to undefined function: get_string()</h4>\r
+<p class="answer">If you see errors like:</p>\r
+<p class="answer">Parse error: parse error, unexpected T_VARIABLE in c:\program \r
+  files\easyphp\www\moodle\config.php on line 94 <br>\r
+  Fatal error: Call to undefined function: get_string() in c:\program files\easyphp\www\moodle\mod\resource\lib.php \r
+  on line 11</p>\r
+<p class="answer">then it's likely you have left out a semi-colon or ending quote \r
+  from a line in config.php (previous to line 94).</p>\r
+<p class="answer">Another reason could be that you have opened config.php in a \r
+  program like Word to edit it, and saved it as a HTML web page, instead of a \r
+  proper text file.</p>\r
+<p>&nbsp;</p>\r
+<h4 class="question"><a name="headerssent"></a>Why do I keep getting error messages \r
+  about &quot;headers already sent&quot;?</h4>\r
+<p class="answer">If you see errors like this:</p>\r
+<blockquote> \r
+  <p class="answer">Warning: Cannot add header information - headers already sent \r
+    by (output started at /webs/moodle/config.php:87) in /webs/moodle/lib/moodlelib.php \r
+    on line 1322 </p>\r
+  <p class="answer"> Warning: Cannot add header information - headers already \r
+    sent by (output started at /webs/moodle/config.php:87) in /webs/moodle/lib/moodlelib.php \r
+    on line 1323 </p>\r
+  <p class="answer"> Warning: Cannot add header information - headers already \r
+    sent by (output started at /webs/moodle/config.php:87) in /webs/moodle/login/index.php \r
+    on line 54 </p>\r
 </blockquote>\r
-</blockquote>\r
-</p>\r
-\r
+<p class="answer">You have blank lines or spaces after the final ?> in your config.php \r
+  file. Sometimes text editors add these - for example Notepad on Windows - so \r
+  you may have to try a different text editor to remove these spaces or blank \r
+  lines completely. </p>\r
+<h4 class="question"><a name="failedopen"></a>I keep getting this error: Failed \r
+  opening required '/web/moodle/lib/setup.php'</h4>\r
+<p class="answer">In your config.php, the setting that you use for the dirroot \r
+  variable must be the <strong>complete path from the root of your server's hard \r
+  drive</strong>.</p>\r
+<p class="answer">Sometimes people only use the path from their home directory, \r
+  or relative to the root of the web server directory.</p>\r
+<p>&nbsp;</p>\r
+<h2>General problems</h2>\r
+<h3 class="question"><a name="filenotfound"></a>Whenever I try to access or view \r
+  a file that I uploaded, I get an error &quot;File not Found&quot;</h3>\r
+<p class="answer">For example: Not Found: The requested URL /moodle/file.php/2/myfile.jpg \r
+  was not found on this server. </span></p>\r
+<p class="answer">Your web server needs to be configured to allow the part of \r
+  the URL after a script name to be passed directly to the script. This is usually \r
+  enabled in Apache 1, but is usually disabled by default in Apache 2. To turn \r
+  it on, add this line to your httpd.conf, or to a .htaccess file in your local \r
+  directory (see the <a href="./?file=install.html#webserver">Install documentation</a> \r
+  for more details): </p>\r
 <blockquote>\r
-<hr>\r
-<p><b>Answer:</b> Your web server needs to be configured to allow the part of the URL \r
-after a script name to be passed directly to the script.  This is \r
-usually enabled in Apache 1, but is usually disabled by default in \r
-Apache 2.  To turn it on, add this line to your httpd.conf, or to \r
-a .htaccess file in your local directory (see the \r
-<A HREF="./?file=install.html#webserver">Install documentation</A> for more details): \r
-\r
-<blockquote>\r
-<pre>\r
-     <b>AcceptPathInfo</b> on\r
-</pre>\r
-</blockquote>\r
-\r
-<p>Note, this will ONLY work for Apache versions 2.x.\r
-\r
-<p>If you are not using Apache 2 and you still have this problem (unlikely) then you \r
-   can switch Moodle to use an alternative method.  The disadvantages are a slight loss of \r
-   performance for your users and you won't be able to use relative links \r
-   within HTML resources.\r
-<p>To use this alternative method: login as Admin, go into the "Configure Variables" page \r
-   and change the setting for "<b>slasharguments</b>".  You should now be able to \r
-   access your uploaded files.</p>\r
+  <pre>\r
+     <span class="answer"><b>AcceptPathInfo</b> on</span></pre>\r
 </blockquote>\r
-\r
-\r
-\r
-\r
+<p class="answer">Note, this will ONLY work for Apache versions 2.x. </p>\r
+<p class="answer">If you are not using Apache 2 and you still have this problem \r
+  (unlikely) then you can switch Moodle to use an alternative method. The disadvantages \r
+  are a slight loss of performance for your users and you won't be able to use \r
+  relative links within HTML resources. </p>\r
+<p class="answer">To use this alternative method: login as Admin, go into the \r
+  "Configure Variables" page and change the setting for "<b>slasharguments</b>". \r
+  You should now be able to access your uploaded files.</p>\r
 <hr>\r
+<p align="center" class="normaltext"><a href='ma&#105&#108t&#111:ma%72%74in@%6d%6fo%64%6c%65.o%72g' title='mar&#116&#105n@&#109oo&#100&#108&#101&#46&#111&#114g'>Suggest \r
+  a new FAQ</a> (include the answer!)</p>\r
+<hr>\r
+<p align="right"><strong><em>Thanks to John Eyre for helping to maintain this \r
+  FAQ.</em></strong></p>\r
+<p align="CENTER"><font size="1"><a href="." target="_top">Moodle Documentation</a></font></p>\r
+<p align="CENTER"><font size="1">Version: $Id: faq.html,v 1.6 2003/03/30 13:54:28 \r
+  moodler Exp $</font></p>\r
 \r
-\r
-<P>&nbsp;</P>\r
-<P ALIGN="CENTER"><FONT SIZE="1"><A HREF="." TARGET="_top">Moodle Documentation</A></FONT></P>\r
-<P ALIGN="CENTER"><FONT SIZE="1">Version: $Id$</FONT></P>\r
-\r
-</BODY>\r
+</body>\r