~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to ivle/webapp/console/help.html

  • Committer: William Grant
  • Date: 2010-02-23 08:55:42 UTC
  • mto: This revision was merged to the branch mainline in revision 1674.
  • Revision ID: grantw@unimelb.edu.au-20100223085542-r8xw14bxxoraza51
Permit underscores in all names.

Show diffs side-by-side

added added

removed removed

Lines of Context:
5
5
<h3>Entering Python code</h3>
6
6
<p>Using the console is fairly straightforward. Enter any valid Python code into the input text box located just to the right of the prompt (<code>&gt;&gt;&gt;</code>) at the bottom of the screen. When the line is complete, press ENTER to execute the code.</p>
7
7
 
8
 
<div class="example" style="border: solid 1px black; padding: 0.5em">
9
 
    <label id="console_prompt">&gt;&gt;&gt;&nbsp;</label>
10
 
    <input id="console_inputText"
11
 
     type="text" size="80" value="print 'Hello, world!'" readonly="readonly" />
12
 
    <input type='button' value='Interrupt' disabled="disabled" />
13
 
    <input type='button' value='Clear Output' disabled="disabled" />
 
8
<div class="console_help_example">
 
9
  <div class="console_heading">
 
10
    Python Console (example)
 
11
  </div>
 
12
  <div class="console_help_example_body">
 
13
    <div class="console_input" style="padding-top: 0.5em">
 
14
      <div>
 
15
        <div>
 
16
          <label class="console_prompt">&gt;&gt;&gt; </label>
 
17
        </div>
 
18
        <div class="console_inputCell">
 
19
          <input type="text" value="print 'Hello, world!'" class="console_inputText" disabled="disabled" />
 
20
        </div>
 
21
        <div>
 
22
          <input type="button" value="Interrupt" disabled="disabled" />
 
23
          <input type="button" value="Clear Output" disabled="disabled" />
 
24
          <input type="button" value="Reset" disabled="disabled" />
 
25
        </div>
 
26
      </div>
 
27
    </div>
 
28
  </div>
14
29
</div>
15
30
 
16
 
<p>Sometimes Python may expect additional lines of input - for example, after the <code>if</code> or <code>for</code> statements. This condition is indicated by a <code>...</code> prompt next to the input. Complete the command by entering additional lines as required. Press ENTER with an empty line to mark the code block as complete and execute it.</p>
 
31
<p>Sometimes Python may expect additional lines of input &mdash; for example, after the <code>if</code> or <code>for</code> statements. This condition is indicated by a <code>...</code> prompt next to the input. Complete the command by entering additional lines as required. Press ENTER with an empty line to mark the code block as complete and execute it.</p>
17
32
 
18
33
<p>Finally, some commands (such as <code>raw_input()</code>) may expect further input from the user. In this case the prompt will be replaced with <code>+++</code> to indicate that input other than Python code is required.</p>
19
34
 
20
 
<p>Please note that the console will time out after a period of inactivity. This has a similar result (and thus similar ramifications) to <a href="#restarting">restarting the console manually</a>.</p>
 
35
<p>Please note that the console will time out after a period of inactivity. This has a similar result (and thus similar ramifications) to <a href="#restarting">restarting the console manually</a>. There is also a limit on the amount of CPU power a single console can use. This limit is in place to prevent accidental monopolisation of resources; if you exceed it, just <a href="#restarting">restart the console session</a>.</p>
21
36
 
22
37
<h3>Interpreting output</h3>
23
 
<div class="example">
24
 
    <div id="console_body">
25
 
        <div style="background-color: gray; border: 2px solid black; padding:       
26
 
        2px; color: black; font-family: monospace; font-weight: bold;">Python 
27
 
        Console</div>
28
 
    </div>
29
 
    <div style="overflow-y: scroll; margin: 0.5em">
30
 
        <code>
31
 
        <span style="color:#800">&gt;&gt;&gt;</span>
32
 
        <span style="color:gray">i</span><br/>
33
 
        <span style="color:red">name 'i' is not defined</span><br/>
34
 
        <span style="color:#800">&gt;&gt;&gt; </span>
35
 
        <span style="color:gray">i=2</span><br/>
36
 
        <span style="color:#800">&gt;&gt;&gt; </span>
37
 
        <span style="color:gray">print i</span><br/>
38
 
        2
39
 
        </code>
40
 
    </div>
41
 
    <div id="console_inputArea">
42
 
        <label id="console_prompt_2">&gt;&gt;&gt;&nbsp;</label>
43
 
        <input id="console_inputText_2" type="text" size="80" value="print i+2" 
44
 
        readonly="readonly" />
45
 
        <input type='button' value='Interrupt' disabled="disabled" />
46
 
        <input type='button' value='Clear Output' disabled="disabled" />
47
 
    </div>
 
38
<div class="console_help_example">
 
39
  <div class="console_heading">
 
40
    Python Console (example)
 
41
  </div>
 
42
  <div class="console_help_example_body">
 
43
    <pre class="console_output outputMsg">
 
44
<span class="inputPrompt">&gt;&gt;&gt; </span> <span class="inputMsg">i</span>
 
45
<span class="errorMsg">Traceback (most recent call last):
 
46
File "&lt;web session&gt;", line 1, in &lt;module&gt;
 
47
NameError: name 'i' is not defined</span>
 
48
<span class="inputPrompt">&gt;&gt;&gt; </span><span class="inputMsg">i = 2</span>
 
49
<span class="inputPrompt">&gt;&gt;&gt; </span><span class="inputMsg">if i == 2:</span>
 
50
<span class="inputPrompt">... </span><span class="inputMsg">    print i</span>
 
51
<span class="inputPrompt">... </span><span class="inputMsg"></span>
 
52
2</pre>
 
53
    <div class="console_input">
 
54
      <div>
 
55
        <div>
 
56
          <label class="console_prompt">&gt;&gt;&gt; </label>
 
57
        </div>
 
58
        <div class="console_inputCell">
 
59
          <input type="text" class="console_inputText" disabled="disabled" />
 
60
        </div>
 
61
        <div>
 
62
          <input type="button" value="Interrupt" disabled="disabled" />
 
63
          <input type="button" value="Clear Output" disabled="disabled" />
 
64
          <input type="button" value="Reset" disabled="disabled" />
 
65
        </div>
 
66
      </div>
 
67
    </div>
 
68
  </div>
48
69
</div>
49
70
 
50
 
<p>Each line that you have entered - as well as any output produced - is shown in the text area above the input. Lines beginning with a normal prompt (<code style="color: #800">&gt;&gt;&gt;</code>) are your input lines, while lines in red (such as <code style="color: red">invalid syntax (&lt;input&gt;, line 1)</code>) are generated errors or exceptions. Other lines are normal output from your code.</p>
 
71
<p>Each line that you have entered &mdash; as well as any output produced &mdash; is shown in the text area above the input. Lines beginning with a normal prompt (<code style="color: #800">&gt;&gt;&gt;</code>) are your input lines, while lines in red (such as <code style="color: red">invalid syntax (&lt;input&gt;, line 1)</code>) are generated errors or exceptions. Other lines are normal output from your code.</p>
51
72
 
52
73
<h3>Reviewing history</h3>
53
74
<p>The IVLE console maintains a log of all entered commands in order to allow simple repetition of history. The up and down arrow keys will scroll backwards and forwards through the input history. As with any other line of code, pressing ENTER will execute the line currently in the input.</p>
57
78
<p>It is possible to enter commands that will render the console unusable or take a long time to complete (infinite loops like <code>while True: print "Hello, world!"</code>, for example). You may terminate execution of the current command with the <em>Interrupt</em> button. This should allow you to resume entering of commands.</p>
58
79
 
59
80
<h3><a name="restarting">Restarting the console</a></h3>
60
 
<p>If things go really wrong, you can restart the console simply by clicking the <em>Console</em> tab. Be aware that you will lose all state (such as variables and functions) entered into your previous console session.</p>
 
81
<p>If things go really wrong, you can restart the console simply by clicking the <em>Reset</em> button. Be aware that you will lose all state (such as variables and functions) entered into your previous console session.</p>
61
82
</div>