The SAGE Notebook

[:days4/projects/: Other SAGE Days 4 Project]

Participants: William Stein, Tom Boothby, Robert Miller, Dorian Raymer, Alex Clemesha, Yi Qiang, Bobby Moretti, and Timothy Clemans.

• A snapshot of work is posted at /home/was/twisted

These are the tasks that need to be accomplished, in order of importance.

1. (mostly done) Twisted Web2 Convert the web server so that it uses twisted's web2 server

   • William -- 4 hours of moving things from server.py; delete worksheet

2. (in progress) A User Model Make it so each user of the notebook has an account on the notebook, and can only see worksheets that are explicitly shared by other users. (I.e., we need either an account and ownership model or a wiki model for the notebook. An account model makes the most sense). [:days4/projects/account: This page has more about the account model.]

   • Yi, Alex, Tom, Dorian, Bobby -- 3 hours for something working and shared among us.
   • Implementing the user model on top -- 6 hours.

3. (mostly done) SSL Encrypted Make it so that the server use GNUTLS to *secure* all communications and logins (current: openssl)

   • Yi -- 1 hour: subclass something and replace listen ssl with gnutls.

4. Secure Separate User Process Create an option so that processes that run the actual worksheets can be started as a different user. This will be slower, but could be vastly more secure.

5. Worksheet Revision Log Revision log for worksheets. like moin-moin; SAVE when -- hit a big "save" button or exit a worksheet.

6. Save/Load Worksheets Rewrite saving/loading of worksheets, so it doesn't use pickle. Instead use the ''s text encoding and the images in directories.

7. Don't loose work If anything in a page changes, make it so trying to navigate away from the page requires confirmation (like in gmail)

8. Internet Explorer support

   • http://www.webdeveloper.com/forum/archive/index.php/t-102141.html

9. Edit mode Finish implementing the html/edit mode: (1) images shouldn't get deleted on saving, (2) inserting new cells shouldn't be broken, and (3) have a better editor (at least syntax highlighted).

If time permits

• Interface issues:
  • Highlighting a block of text and pressing tab indents it four spaces; similarly, pressing shift-tab dedents it four spaces.
  • In the notebook some input cell should *always* have focus, if this is possible. I hate typing into a worksheet and having random movement happen.

• Create a worksheet settings panel; use this to:

  • Set the math software system used to evaluate cells
  • Determine whether pressing shift-enter jumps to the next cell or stays in current one.

  • Create a notebook settings panel:

    • Whether or not left panel is displayed by default
    • Whether shift enter or enter evaluates a cell (Mathematica or Maple mode)
    • Default math software system for new worksheets.

• New feature -- pdf printing; Printing needs to also allow for the following: Given a single worksheet, print it by (1) saving it to a latex file with embedded images, and (2) running pdflatex on the result, then return the resulting pdf file and/or a tarball with the images and latex. This would be very high quality, and will also be something that would be easily included in latex documents. Printing a notebook (=all worksheets owned by a given user) would create a document with a section for each notebook.

• Published notebook should be rate-able.
• Focus-on-cell mode should flip through slides, which should be well-defined sections of the worksheet.
• Implement correct tab completion in the worksheet when in system-other-than-sage mode (i.e., don't put magma.foo[tab])

• Add support for user javascript in the worksheet cells along with basic graphics (Robert Miller). See http://www.sagemath.org:9002/sage_trac/ticket/359

• Come up with clever new ideas to address the "jupiness" of the notebook, e.g., Justin Walker reports that in Safari under OS X, "I reach the bottom of the visible page, and scroll down to make the next cell visible, enter an expression, and hit SHFT- Return, the page jumps back to the top."

• Implement some of the features of Google Notebook (http://www.google.com/notebook) -- note we were before them.

  • Full search of all worksheets
  • Cleaner display of worksheet list on the left
  • Drag and drop
• (I'm *not* convinced that this is the right thing to do, or should be a high priority). New directory structure / never an sobj -- *BUT* maintain backwards compatibility with existing notebooks (!).
  • /notebook
    • config.txt #config file for notebook in standard config file format
    • /history

    • /data (contains objects & stuff)

    • /codes (contains attachable scripts & stuff)

    • /worksheets
      • /_scratch_ (for example)
        • _scratch_.txt (contains worksheet wiki text + config-file format header)
        • /cells
        • /images?

    • /userinfo (contains SQLite database to control access / session / user stuff & stuff)

  • Note -- when one saves a worksheet (or set of worksheets), all objects that they link to must be included in the saved worksheet!

• Javascript feature: click & drag on a plot to zoom. Tom really wants this. Bobby seconds this. It's a killer feature. Perhaps google maps style?

• Create a quiz-mode for worksheets, which satisfies the requirements of a quiz system.