There are essentially two ways to create CindyJS content. Either you edit the HTML file manually, or you create the content in Cinderella.
Exporting from Cinderella
In recent versions of Cinderella, the “File” menu has an entry called “Export to CindyJS” which will create an HTML file with CindyJS content in it. You can either directly publish that, add descriptive text, or edit the exported document as described below.
Be aware that not all features of Cinderella will be supported by CindyJS yet. So have a look at the list of known compatibility issues and test the exported file. Also be sure that if something (like some geometric element or some label) vanished by exporting, you don't rely on the fact that it did vanish. We might add support for that feature later on, causing it to suddenly reappear.
Manual HTML editing
If you want to build the HTML file manually, it might be best to start by adapting an existing example. There are three relevant parts to most CindyJS widgets:
- Reference the
Cindy.jsscript in your HTML file, by adding the following line to the header of your file:
This adds a function called
CindyJSto the global scope.
- For custom actions beyond simple dynamic geometry,
you can write CindyScript code encosed in HTML
<script>tags. Some CindyScript documentation is available, but it often refers to functionality of Cinderella, not CindyJS.
There is a CindyGL-Tutorial, that is also suitable for starting with CindyJS.
At this point there are no further official tutorials for CindyJS. If you want to write one, please contact the development team. If you follow the route of exporting content from Cinderella, one of Cinderella's tutorials might appeal to you.
A somewhat less technical version which is still very similar is the CindyScript documentation for Cinderella. The reference manual started out as a copy of this, but has developed with a slightly different goal since then, adding technical descriptions and testable examples. Some other parts of the Cinderella documentation might be applicable to CindyJS users as well, particularly if you export content from Cinderella. If you prefer to hold paper in your hands, the Cinderella manual has also been released as a book.