Introduction
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.
Before You Start
Search through the existing Demonstrations for topics close to yours. Some topics in the site, like trigonometric functions, are very dense, so vary your search terms to make sure you see everything relevant. It is fine if there is already something similar to your idea--just give your Demonstration a different emphasis.
Demonstration Title
- 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.
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 better than an animation the user cannot control.
- Label controls clearly with English words; "number of
subdivisions" is more instructive than "n."
InputField is not supported by Mathematica Player so cannot be used in
Demonstrations.
- Set
Appearance->"Labeled" for any slider whose
values you want to display to the right of the slider. Display other
useful data in the content area of the Manipulate, possibly as a PlotLabel.
- Nested Manipulates or functions that return Manipulate are not allowed. Keep things simple and use only one Manipulate command per Demonstration.
- Appearance
-> "Open" is not allowed for Manipulator
controls in Demonstrations, as it takes up precious screen space and
users can open the controls manually.
- Manipulate's Autorun feature
is the basis for each Demonstration's Flash preview. Access it by
clicking the + menu in the upper right of the Manipulate
output. Test your Autorun to make sure everything looks correct and
that the result does not resize.
Authoring Information
The first line should always be "Contributed by: [author's name]"
Possible additional lines include:
- "Based on a program by:..." if code from another program was used.
- "Suggested by:..." if someone suggested the idea to the author.
- "After work by:..." if the Demonstration builds on a book, paper, etc.
Testing Your Demonstration
Check your Demonstration before you upload it to help speed it through our review process for publication.
- The Demonstration's screen size, including its controls, should not change as controls are manipulated. It should be larger than the white area of the Test Image Size palette (in the Tools menu), but smaller than the greenish area. Consider setting an
ImageSize option or using a Pane construct to control the size of your Demonstration.
- Move each control to its limits. Check for any error messages, clipping, or unnecessary slowdowns.
- As you move the controls, check for any jiggling of the
Manipulate contents. You can eliminate jiggling by using the PlotRange or ImagePadding options, Spacers, or a Pane construct.
- Review and edit the Caption and Details sections to make them as clear as possible.
- Use the Check Spelling button in the Tools menu.