================== SageMath in Debian ================== Unavailable features ==================== Some features of SageMath in Debian are unavailable for various reasons. These are summarised below; see the respective packages for more details. 3D plots -------- From web-based notebooks, the default viewer for 3D plots (JSmol) is currently unavailable in Debian, because it does not satisfy the Debian Free Software Guidelines. It may be possible to resolve this, but it would take a lot of work - see the jmol package documentation for details. As a work-around, you can specify a different viewer; one of "threejs", "canvas3d" (SageNB only) or "tachyon". In the standard Sage command-line interface, the default viewer is Jmol (the Java counterpart to JSmol) and this should work fine. SageNB ------ HTTPS is unsupported, because certtool is not yet in Debian - see the sagenb package documentation for details. Optional packages ----------------- Sage's "optional" packages are unsupported in Debian at the current time. Some of them might "accidentally" half-work, but the Debian Sage Team cannot handle support requests relating to this and will close bugs as "wontfix". Known issues ============ At the moment, some things are not working, or working a bit roughly: - Jupyter notebook: there are errors in the browser console relating to loading MathJax fonts but this doesn't seem to interfere with the functionality. Running doctests ================ One can run the tests using the installed sage packages. First, get the source code for this package (`apt-get source sagemath`), and make sure the Debian patches are applied. Then, from any directory: *$ export -n SAGE_LOCAL SAGE_ROOT *$ SAGE_SRC=/path/to/sage/src \ SAGE_PKGS=/path/to/sage/build/pkgs \ sage -t -p --long --logfile=ptestlong.log --all It's recommended that you install *all* packages, including all documentation packages in all languages, when running these tests. Otherwise you will see more failures than necessary. They are easy to ignore, but every person that reads the results will have to figure this out, wasting time. Feel free to upload your test logs somewhere and send links to them to our mailing list . Please do not send your test logs directly, unless they are small (<400KB). Compressing them would be a good idea, if that helps to bring the size down. If you wish to help debug and fix test failures, see debian/README.source in the source package for more guidance on how to do that. In particular, you will need to build the source from scratch first.