← Back to branch summary

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

« back to all changes in this revision

Viewing changes to ivle/webapp/filesystem/browser/help-run-serve.html

  • Committer: David Coles
  • Date: 2010-07-28 10:52:48 UTC
  • mfrom: (1791.2.10 mediahandlers)
  • Revision ID: coles.david@gmail.com-20100728105248-zvbn9g72v1nsskvd
A series of HTML5 based media handlers using the <audio> and <video> tags.  
This replaces the previous page that just showed a download link (which is 
already available on the menu).

Also solves issue where media files were downloaded by the client twice (once 
in an AJAX request intended only for text).

Known issues:
    * Bug #588285: External BHO will not be able to play media due to not
      having IVLE cookie.
    * Bug #610745: Does not correctly preview revisions
    * Bug #610780: Ogg media does not work in Chromium

Show diffs side-by-side

added added

removed removed

Lines of Context:
ivle/webapp/filesystem/browser/help-run-serve.html
 
1
<div class="helpfile">
 
2
<p>You can <strong>run</strong> Python code directly from the IVLE File
 
3
Browser to try it out. You can also <strong>serve</strong> Python web
 
4
applications and other files publicly.</p>
 
5
 
 
6
<h2>Running</h2>
 
7
 
 
8
<p>In the IVLE Editor, you can create Python scripts (<strong>.py</strong>
 
9
files), which contain working programs. Often, simple programs work by
 
10
printing things out (with the <strong>print</strong> statement), and reading
 
11
input from the user (with the <strong>raw_input</strong> function).</p>
 
12
 
 
13
<p>You can run these programs by selecting the <strong>.py</strong> file in
 
14
the File Browser, and clicking <strong>run</strong>. This will open up the
 
15
Python console and display the output of the program, just as if you had typed
 
16
the program into the console yourself.</p>
 
17
 
 
18
<p>For example, the following simple Python program prints a message:</p>
 
19
 
 
20
<pre>print "Hello, world!"</pre>
 
21
 
 
22
<h2>Serving</h2>
 
23
 
 
24
<p>IVLE also allows you to create web pages or web applications to show to
 
25
your friends. In the IVLE Editor, you can create HTML web pages
 
26
(<strong>.html</strong> files). For example, the following page contains a
 
27
message:</p>
 
28
 
 
29
<pre>&lt;html&gt;&lt;body&gt;&lt;p&gt;Hello, world!&lt;/p&gt;&lt;/body&gt;&lt;/html&gt;</pre>
 
30
 
 
31
<p>You can ask IVLE to serve such a file as a web page by selecting the
 
32
<strong>.html</strong> file in the File Browser, and clicking
 
33
<strong>serve</strong>. This will open a new tab with the web page.</p>
 
34
 
 
35
<p>You can also run a Python file as a web application in the same way. In
 
36
IVLE, we use CGI to write web applications in Python, which are a little
 
37
different from a normal Python script. If you serve the above script, you will
 
38
see a warning, explaining that you didn't use CGI properly. An example of a
 
39
simple CGI script follows:</p>
 
40
 
 
41
<pre>print "Content-Type: text/html"
 
42
print
 
43
print "&lt;html&gt;&lt;body&gt;&lt;p&gt;Hello, world!&lt;/p&gt;&lt;/body&gt;&lt;/html&gt;"</pre>
 
44
 
 
45
<h2>Publishing</h2>
 
46
 
 
47
<p>If you wish to show your web pages and applications to the world, first,
 
48
select nothing and choose <strong>publish</strong> from the "More actions"
 
49
menu. This will <em>publish</em> the directory and all files in it to the
 
50
web.</p>
 
51
 
 
52
<p>Then, select the file, and choose <strong>share this file</strong> from the
 
53
"More actions" menu. This will open the file in a new tab, just like
 
54
<strong>serve</strong>, except the address bar will show a "public" URL. If
 
55
you give this URL to someone else (e.g., as a link in an email), they will be
 
56
able to view your content.</p>
 
57
 
 
58
<h2>Summary</h2>
 
59
<ul>
 
60
<li><strong>Run</strong> runs Python programs as command-line applications.</li>
 
61
<li><strong>Serve</strong> runs Python programs as CGI applications, showing their web output.</li>
 
62
<li><strong>Publish</strong> lets other people view your web pages and CGI applications as if they were <strong>served</strong>.</li>
 
63
</ul>
 
64
</div>