Difference between revisions of "Editing the mechatronics wiki"
| Line 38: | Line 38: | ||
[[Image:mrh_box.JPG|thumb|150px|[[Mozart's Right Hand|Project 1]]|right]] |
[[Image:mrh_box.JPG|thumb|150px|[[Mozart's Right Hand|Project 1]]|right]] |
||
Sometimes you want to give step-by-step instructions or description, with an image for each step. To keep the text lined up with the images, you can use a <nowiki><br clear=all></ |
Sometimes you want to give step-by-step instructions or description, with an image for each step. To keep the text lined up with the images, you can use a <nowiki><br clear=all></nowiki> command to make sure that everything after that command will appear below the preceding photo and text, which makes sure that the next text is lined up with the next photo. |
||
<br clear=all> |
<br clear=all> |
||
Revision as of 22:43, 21 April 2009
The easiest way to get started is by looking at the code of an existing page that is formatted in a way you like.
You can learn more about editing a wiki by going to wikipedia's help page. Below are some basic guidelines to get you started. You can click on "edit" at the top of this page to see the wiki code that generates this page. Experiment with the formatting buttons at the top of the editing page to see what they do.
Level 1 Headline
Level 2 Headline
Level 3 Headline
If your wiki page has headlines, generated for example by the code
= Level 1 Headline =, == Level 2 Headline ==, and === Level 3 Headline ===
the page will automatically create a table of contents before the first headline. Most pages do not need more than one level of headlines, and the formatting buttons at the top of the edit page provide you access to "Level 2 Headlines," so you should just use that by default, unless you have reason for more levels of headlines.
(Note the use of the "nowiki" command above that allows what you type to appear as you wish without wiki formatting.)
Topic and Name of Your Page
To create a new page, simply make a reference to it in an existing page by using code such as this: [[Page Name | the text you use to refer to the page]], or simply [[Page Name]]. Then you can click on the link created in the existing page and it will open the new page for editing. To make your page as useful as possible, it should have an informative, succinct name (which can be found by searching) and be focused on a particular topic. It should also be properly indexed so users can find it by browsing. If there is already a page on a similar topic, consider modifying that page rather instead of making another page with similar content. If you make significant changes, you should provide the reason for your changes when you save the edit. If you are writing a page on a large project, but there is a particular new capability that you've contributed, then consider creating a separate page and indexing it in the wiki appropriately, so others can find it without having to search your entire project page.
It is a good idea to provide links to other related helpful sources, on this wiki or external (for example wikipedia). Wikipedia uses references that appear at the end of the page, but this is not necessary.
Creating Internal and External Links
Use links to help the reader find more information. When you link to a page on this wiki, use an internal link such as this, generated by [[Main Page | this]], instead of an external link such as this, generated by [http://hades.mech.northwestern.edu/wiki this]. This is so the link will continue to work even if the wiki is moved to another server.
Including Images and Other Media
Do not use copyrighted material. If you find material on the web that is useful, you can link to the appropriate pages. If you get an image from a web page that is useful for your page, be sure to provide an acknowledgment and a link to the original page.
When you are saving an image or other media file on the wiki, make sure to give it a unique name. For example, "circuit-diagram.jpg" would not be a good name. If you are documenting a project by Anita Brown, Chuck Davis, and Eileen Finnegan, for example, you could begin each uploaded file name with the initials of the group, e.g., "AB_CD_EH_circuit-diagram.jpg."
In general, images should be at the right and relatively small, i.e., thumbnails. You can edit this page to see how the images are formatted to be thumbnails at the right. The caption can be a link to another page or just text. When the user clicks on the image, they see the full size image. Make sure the full-size image is large enough to see necessary detail, but don't upload unnecessarily large photos.
Sometimes you want to give step-by-step instructions or description, with an image for each step. To keep the text lined up with the images, you can use a <br clear=all> command to make sure that everything after that command will appear below the preceding photo and text, which makes sure that the next text is lined up with the next photo.
[[Image:Persistence of Vison Display|right|thumb|150px]|Project 2] And here is the text for Project 2, with the image to the right of this text.
Other than image files, you might want to upload pdf files or movie files. As a rule, don't upload very large files, or files that can reliably be found elsewhere. If the file can be found elsewhere on the web, just use a link. Movie files more than 1 or 2 MB should be uploaded to youtube and linked to. You can link to a pdf file like this link to a motor data sheet. blah
youtube, pdf
Making a List
Including Math
Bold text
