Mathics-django

-----

Fix a small packaging issue where we weren't install ``autoload/settings.m``.
This combined with a bug in Mathics core was causing evaluationg expressions
to fail.

-----

The main thrust behind this API-breaking release is to be able to
support a protocol for Graphics3D.

It new Graphics3D protocol is currently expressed in JSON. There is an
independent `threejs-based module
<https://www.npmjs.com/package/mathicsorg/mathics-threejs-backend>`_
to implement this. Tiago Cavalcante Trindade is responsible for this
code.

Previously, this Javascript code and library was embedded into this
code base. By separating the two, this library can be used more easily
outside of Django. And the library has gotten considerably better in
terms of being tested and documented.

The other main API-breaking change is more decentralization of the
Mathics Documentation. A lot more work needs to go on here, and so
there will be one or two more API breaking releases. After this
release, the documentation code will be split off into its own git
repository.

Enhancements
++++++++++++

* a Graphics3D protocol, mentioned above, has been started
* ``mathics_django.setting`` has been gone over to simplify.
* The "about" page now includes the Python version as well as the
mathics-threejs-backend version
* Some Image Gallery examples have been added. Some of the examples
have been reordered to put the slower examples towards the end.
* Much of the Javascript code that remains after pulling out the
Graphics3D code has been modernized.
* Use of the "scriptaculous" library has been reduced. It will be
eliminated totally in a future release.


Documentation
.............

* Document data used in producing HTML-rendered documents is now
stored in both the user space, where it can be extended, and in the
package install space -- which is useful when there is no user-space
data.
* Code duplication used in creating documentation has been reduced. It
will be moved more completely out in a future release
* Summary text for various built-in functions has been started. These
summaries are visible in Mathics Django when lists links are given
in Chapters, Guide Sections, or Sections. See the online
documentation of ``Associations`` for an example of a list with
additional summary information.

Regressions
+++++++++++

* Some of the test output for buitins inside a guide sections is not
automatically rendered. See the on-line documentation for ``Binarize`` for
an example of this.
* Density plot rendered in Mathics Django do not render as nice since we no longer
use the secret protocol handshake hack. We may fix this in a future release

-----

Use NPM package `mathics-threejs-backend <https://www.npmjs.com/package/mathicsorg/mathics-threejs-backend>`_ to provide 3D Graphics rendering via `three.js <threejs.org>`_.

-----

* Add ``Arrow`` and ``Cylinder`` (preliminary)
* Improve sectioning and subsectioning. (A lot more could be done on both the data tagging and presentation side)
* Improve gallery examples
* Modernize Javascript code more and get closer to removing scriptaculous

-----

Fix packaging issues: ``settings.m`` wasn't getting included in package.

-----

This release contains been a major overhaul and upgrade of the code.

It can't be stressed enough, but this was made only possible due to
the tireless work of Tiago Cavalcante Trindade.

There is still a lot of work still to do. However where we are at
right now, there have been massive changes and improvements:

* three.js has been upgraded to r124 (from r52) which brings us from
up seven years from circa 2013 to late 2020!
* Plots and Graphs no longer appear inside MathML when there is no reason for them to be in MathML.
* The "About" page now shows all of the the Mathics ``Settings`` that
are in effect. You can change Boolean setting inside the About page.
* 3D Polygon rendering has been greatly improved. However we currently
do not handle even/odd space filling.
* We support TickStyle coloring in 3D Graphics.
* Tick positions in most 2D Plots and Graphs as been fixed.
* We tolerate smaller screens in SVG rendering.
* Styling of Cells has been improved. A somewhat Jupyter-style frame box is used.
* Output which are strings now have surrounding quotes. (This can be
turned off via ``Settings`$QuotedStrings``.)
* In headings, we make it more clear that the code is Django
based. This is to make clear the distinction should there be a
Flask-based front-end or the long sought for Jupyter front end.
* In the online document, sections which are empty are omitted from
the online view.
* A stray in the space between logo and Mathics at the top was removed.
* Gallery examples have been improved.
* A major rewrite of the JavaScript code according to more modern
Javascript style has been started. More work will probably continue
in future releases.
* Respecting ``PointSize`` in the rendering of 3D plots as been
fixed. The default point size now more closely matches the intended specification.
* The use of Prototype and Scriptaculous are being phased out.