This page provides guidelines for authors creating or editing Demonstrations. The Participate page has all the information you need to make a Demonstration—this page gives tips that authors have found useful.
- Make the title as specific as you can. "Density Map for the 3n + 1 Problem" is a better title than "3n + 1 Problem."
- The Demonstration's title and file name are generated from what you enter in this section, so the file name of the notebook you upload does not matter.
- The permanent URL of a Demonstration is also generated from the title. We encourage authors to use standard English alpha numeric characters, because the URL syntax does not support many characters from outside this set.
Controls for Your Manipulate
- Choose your controls judiciously. Unnecessary clutter only distracts from the idea of your Demonstration.
- Let the sliders do the animating. A slider that steps through an evolution is usually better than an animation the user cannot control.
- Label controls clearly with English words: "number of subdivisions" is more instructive than "n."
InputFieldis not supported in Demonstrations.
Appearance->"Labeled"for any slider whose values should be displayed to the right of the slider. Display other useful data in the content area of the
Manipulate, for instance as a
- Nested instances of Manipulate or functions that return Manipulate are not allowed. Keep things simple and use only one Manipulate per Demonstration.
- Appearance->"Open" is not allowed for Manipulator controls in Demonstrations, as it takes up precious screen space. Users can open the controls manually.
Testing Your Demonstration
Check your Demonstration before you upload. This will speed it through our review process.
- The Demonstration's screen size, including its controls, should not change as controls are manipulated. The outer border of each Demonstration should lie outside the white area of the Test Image Size palette and inside the translucent green area. The palette is located in the Tools menu. Also, consider setting an
ImageSizeoption or using a
Paneconstruct to control the size of your Demonstration.
- Move each control to its limits. Check for any error messages, unnecessary slowdowns, or other signs of improper function.
- As you move the controls, check for any jiggling of the
Manipulatecontents. You can eliminate jiggling by using the
Spacers, or a
- Review and edit the Caption and Details sections to make them as clear as possible.
- Use the Check Spelling button in the Tools menu.