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

« back to all changes in this revision

Viewing changes to doc/app_howto.txt

[Uber-commit of holiday work because I lacked a local copy of the branch.]

 ivle.makeuser: Don't use jailconf.py as a header for the in-jail conf.py;
     generate the whole thing using string formatting operators and include
     the template inline.

 ivle.makeuser.make_conf_py: XXX the inclusion of ivle.conf.jail_base in
     the jail. It is simply there to placate ivle.studpath, and needs
     to go before we can entirely remove the in-jail config.

 ivle-buildjail:
   - Add. Converted from setup.buildjail.
   - Build the jail in __base_build__ and rsync it to __base__ when
     done, rather than operating only in ./jail
   - Rename --rebuildjail/-j to --recreate/-r, as the whole script
     is now for jail rebuilding. Also add a warning to the usage string about
     the large volume likely to be downloaded.
   - Check existence before removing trees.
   - Don't copy jailconf.py over conf.py in the jail. Also make
     sure that we remove conf.pyc.

 setup.configure:
   - Stop generating jailconf.py at all.
   - Add a jail_system_build setting, defaulting to __base_build__ next to
     the existing __base__.
   - Don't use an OptionParser before calling the real function, as that
     adds options dynamically.

 setup.install:
   - Add an option (-R) to avoid writing out svn revision info to
     $PREFIX/share/ivle/revision.txt.
   - Remove jail-copying things.
   - Install all services to the host, rather than just usrmgt-server. We do
     this so we can build the jail from the host without the source tree.
   - Shuffle some things, and don't install phpBB3 twice.
   - Add a --root argument, to take an alternate root directory to install
     into (as given to autotools in $DESTDIR).

 setup.build:
   - Allow running as non-root.
   - Take a --no-compile option to not byte-compile Python files.

 setup.util:
   - Include usrmgt-server in the list of services.
   - Add make_install_path(), a wrapper around os.path.join() that ensures
     the second path is relative.
   - Install ivle-buildjail with the other binaries.

Show diffs side-by-side

added added

removed removed

Lines of Context:
143
143
    def handle(req):
144
144
        req.content_type = "text/html"
145
145
        req.write_html_head_foot = True
146
 
        req.write("<p>Hello, IVLE!</p>\n")
 
146
        req.write("<div id="ivle_padding">\n")
 
147
        req.write("  <p>Hello, IVLE!</p>\n")
 
148
        req.write("</div>\n")
147
149
 
148
150
Now, edit the file `conf/apps.py`, and add the following lines:
149
151
 
165
167
XHTML body element. The final output will be valid XHTML 1.0 Strict if the
166
168
application's output is.
167
169
 
 
170
Note that by default, there is no padding around the application's HTML
 
171
output. This is because more complex apps (most of ours) don't work properly
 
172
with padding. Simpler apps (which simply write HTML paragraph content) look
 
173
better with padding.  Apps can wrap all of their output in a
 
174
'<div id="ivle_padding">' element (as shown above) to get padding.
 
175
 
168
176
### Making a file dump ###
169
177
 
170
178
You can modify the application to dump files from the students directories