Structure of Image pages

From Math Images
Revision as of 11:53, 30 November 2010 by Gene (talk | contribs) (New page: ===Creating an Image Page=== Once you are logged in, and you have a math image you would like to contribute to our site, you can add it to our wiki! Click on Create an Image Page, under '...)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Creating an Image Page

Once you are logged in, and you have a math image you would like to contribute to our site, you can add it to our wiki! Click on Create an Image Page, under 'interaction' on the sidebar. Enter the name of the Math Image Page you would like to create (so, if I am making a page about an image called Clown.jpg, I might enter Clown as the page name). After clicking 'Add or edit page', a form will come up, which should be empty. If it is not empty, that means that there is already a Math Image page by that name. You should check to make sure that the image you uploaded is not the same as the one on the pre-existing page. If they are different, you should come up with a new page name. Once you have a blank form, fill it in with these guidelines:

  • Image Title- this should be the title of the image (ex., Clown)
  • File- here, click the 'Upload a Math Image' link. A pop up form will appear, prompting you to upload your math image to the site. Click on the Browse button and select the image you wish to upload. Now type in a relevant destination filename (for example, if my image is of a clown, and it is a .jpg file, I would set the destination filename to be Clown.jpg). Now write a quick summary of the image.
  • Short Description- this should be a 1 or 2 sentence long basic description of the image
  • Basic Explanation- this should be a description of the image that is put in terms that pre-college students and other people without a rigorous math background could get some basic understanding
  • More Detailed Explanation- this should be a description of the image that is more in depth so that college students and others with a deeper math background can get gain a deep understanding for the math behind the image
    • What subject(s) is(are) necessary to understand the above explanation (if applicable)- enter what math subjects would be useful for understanding the image (e.g., Linear Algebra or Real Analysis)
  • Who (or What) Created this Image- the name of the creator of the image, whether person or program (if you do not know the author, simply put "Unknown")
  • About the Author- a quick biography of the author or description of the program
  • Image's Site of Origin (name)- the name of the site the image came from
  • Image's Site of Origin (URL)- the URL of the main page of the site the image came from
  • Image's Field of Mathematics- the fields of mathematics to which the uploaded image is a part of (the first one should be the primary one, i.e. the field under which the image will appear in the thumbnail gallery and slideshow)
  • Why is this interesting? (mathematically or otherwise)- what inspired you to make this page
  • How does your main image relate to the topics discussed?- this is more important for abstract images that are harder to link directly to the math discuessed
  • Links to Other Sites about this field- other useful sites about the same field
  • References- please list any references you used in creating the page
  • Things This Page Needs in the Future- help determine the future direction the page could take
  • Is This Page a Work in Progress- although we feel all pages are technically works in progress indefinitely, please check this box when the page still requires significant contributions

Writing Guide

  • Look through the help documents, especially the Wiki Tricks page so you know what resources this wiki has available to you.
  • Make sure you have made an account and log in to create a new math images page (you can edit existing pages without an account, but we recommend making an account if you are going to edit or write on this wiki).
  • We want our image pages to have an attractive image, together with descriptions of the math behind it that can be satisfying to users with many different levels of background. Start out with a very simple overview, likely hiding much of the more advanced material to keep from overwhelming readers (in particular going very light on equations). We've found it useful to keep the names of hidden subsections visible, serving as a come-on, but hiding the subsection contents (although maybe showing an intriguing image or so).
  • In general use short paragraphs of just a couple sentences, and simple sentences. It's a real challenge to write clearly, simply, and still convey the mathematical concepts. Almost everyone needs to have their work read by others and to revise.
  • For Math Image pages, or Helper Pages which double as math image pages, be sure to use the form, as described in the section above, to create or edit pages. For simpler Helper Pages, the form isn't necessary and just a simpler approach, using many of the tricks from the advanced user guide would suffice.
  • Search what pages already exist! There might already be some pages similar to the one you wanted to do, which could help you in making your page or give you related articles to link your page to. If a Math Image page already exists that is extremely similar to the one you were planning, perhaps you could merge your planned page and the already existing one (before such a large overhaul it would be considerate to plan it out with others in the discussion pages, however).
  • Subsections within each section on the form should start out using a triple header, e.g. ===Subsection Name===
  • Whenever a section of math can be particularly overbearing, at least at first glance, it might be wise to hide it (to learn about hiding sections, see the Wiki Tricks page) so that readers have time to read a little bit of background information before being loaded with equations.
  • You can put other images in your page besides just the main one, in fact this is highly encouraged as long as they are relevant
  • For definitions that many users may already know, use a mouse-over balloon to explain it briefly, and perhaps have the mouse-over also serve as a link to any relevant Helper Pages. For more information on mouse-overs, see the Wiki Tricks page.
  • If you don't understand some of the more sophisticated math for a page you are creating, you can leave a section blank and ask in the discussion and community portal for someone who does understand it to help you write it.
  • Be sure to reference any resources you found especially useful in creating your page! At least two references is a good thing.


Further questions?

The basics of using this wiki have been covered on this page. Before posting any questions you may have, though, please check the Advanced User Guide to make sure your question is not answered there.

If you have questions not answered here or on those pages, you can post them here.