================== SageMath in Debian ================== 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 the main source directory: *$ SAGE_SRC=$(pwd)/sage/src sage -t -p --long --logfile=ptestlong.log sage/src/sage It's recommended that you install *all* sagemath packages when running these tests. Otherwise you will see more failures than necessary. 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. 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. 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.