3D Plots
========

Interactive 3D plots using the default viewer do not work in SageNB because
JSmol cannot currently be packaged for Debian. See the README.source of the
jmol package for more details on this situation.

You can view an interactive plot with reduced functionality by giving the
option `viewer='canvas3d'`, or a non-interactive plot by giving the option
`viewer='tachyon'`. Also, interactive plots with Jmol do work from the SageMath
command-line interface.

3D plots do work from the SageMath command-line interface.

(The upstream code claims to support using the old Jmol applet instead of
JSmol, but this is just because it was not updated properly over the years, see
https://github.com/sagemath/sagenb/issues/415)

Secure Notebook
===============

This current version of the SageNB Debian package does not yet support secure
(HTTPS) operation. This is because the `certtool` program is not yet available
in Debian. To fix this, we have a few options:

- package certtool for Debian
- patch SageNB to use openssl instead of certtool

but I don't know when I'll be able to get around to this myself. In the
meantime, patches are welcome! Or, you have a few workarounds:

- use a reverse proxy server that supports HTTPS
- if you just need it for personal use, you can use a SSH local forward:

  your_work_client$ ssh -L 8080:localhost:8080 your_sagenb_server

  will allow you to connect to localhost:8080 *on your_work_client*, in order
  to access the SageNB instance running on your_sagenb_server.

Color pickers
=============

Upstream SageNB uses 3 different types of color picker that the user can choose
from. These use extremely old code, seem to be abandoned by their authors, and
are a pain to package.

Instead of these, Debian uses vanderlee's colorpicker, which is easier to use,
actively maintained, and was already available in the libjs-jquery-colorpicker
package. It is used *in place* of the old default "colorpicker" colorpicker.
The other values, "jpicker" and "farbtastic", will raise an error in Debian.

Please do file bugs in case there are any issues with this. However, I can say
that I will not switch this package to the old arrangement, but rather would
try to fix any issues with the new arrangement. Hopefully there are none.