SOCR EduMaterials GuidelinesWikiEditing

From SOCR
Jump to: navigation, search

SOCR Educational Materials - SOCR Wiki Editing Guidelines

This is a brief outline of the most common SOCR Wiki Resource Editing Tasks and should be used in addition to the MediaWiki Editing Tutorials

Get a SOCR Wiki Account

SOCR GuidelinesWikiEditing Dinov 102006 Fig1.jpg

Choose a (root) page to link your new document off of

  • Go to the Main SOCR Wiki (Main_Page), follow the hierarchy and start at the page which is the most natural parent of the material you are going to propose. You can also generate a stand-alone Wiki document, but you should avoid that. Always try to find where your future document belongs first. Then go to this page and edit this page (edit tab on top of page) to include a link to your new document.
SOCR GuidelinesWikiEditing Dinov 102006 Fig2.jpg
  • In the root page you may include a code like this to generate a link to your future SOCR Wiki Page: [[SOCR_MainTopic_SubTopic_SubSubTopic_NewTopic_Author_Date]]. This link should be properly placed in the parent (root) page (location, context, etc.)
SOCR GuidelinesWikiEditing Dinov 102006 Fig3.jpg

Naming of your new SOCR Wiki documents

  • We recommend the following naming-convention to avoid potential document confusions
    • For more stable links: [[SOCR_MainTopic_SubTopic_SubSubTopic_NewTopic]], e.g., SOCR_EduMaterials_Activities_Standard52CardDeck
    • For more dynamic and frequently revised documents by many people: [[SOCR_MainTopic_SubTopic_SubSubTopic_NewTopic_Author_Date_Version]]

Saving New-Page-Link in Root Page

  • Now save your link in the parent (root) page: click the save page button on the bottom of the editing-mode Wiki pages. This will show you the newly redesigned root page that contains an explicit link to your new page, e.g., [[SOCR_MainTopic_SubTopic_SubSubTopic_NewTopic_Author_Date_Version]]
SOCR GuidelinesWikiEditing Dinov 102006 Fig4.jpg

Edit the new SOCR Wiki document

  • Click on the new link that you created in the root-page, [[SOCR_MainTopic_SubTopic_SubSubTopic_NewTopic_Author_Date_Version]]. This should put you directly in editing-mode of your new SOCR Wiki document (unless such a page already exists, then you will see this page, and you still can get in its editing mode by clicking the edit tab-pane on the top, as before).
SOCR GuidelinesWikiEditing Dinov 102006 Fig5.jpg

Images in SOCR Wiki documents

  • Before you include (JPG) images in your SOCR Wiki pages you must save the images (use proper names, see below) on your client computer.
    • Naming your SOCR Wiki Images:
      • Example: SOCR_Activities_CardCoinSampling_Dinov_092206_Fig1.jpg
      • General Image Naming Convention: SOCR_MainTopic_SubTopic_SubSubTopic_Title_Author_Date_FigNo.jpg
    • Uploading Images: Click on the bottom-left side Toolbox link: Upload file and follow the instructions to upload your < 1MB JPG image(s).
    • Include your Image in your new Wiki document: Go back in the editing mode of your new SOCR Wiki page. A variant of this command [[Image:http://wiki.socr.umich.edu/socr/uploads/e/e1/SOCR_Activities_CI_Dinov_092206_Fig1.jpg|300px]] will include your image as follows:
SOCR Activities CI Dinov 092206 Fig1.jpg

Tables

  • This code generates the table below (entered one-cell per line - e.g., | cell(2,2)): {| align="center" border="1" | colspan="5" align="center"| Common Top Row |- | rowspan="3"| Common First Column | cell(2,2) | cell(2,3) | cell(2,4) | cell(2,5) |- | cell(3,2) | cell(3,3) | cell(3,4) | cell(3,5) |- | cell(4,2) | cell(4,3) | cell(4,4) | cell(4,5) |}. You can copy, paste and revise this code according to your table needs in the editing mode of your new Wiki page (remember that each cell value must the entered on a new line!)
Common Top Row
Common First Column cell(2,2) cell(2,3) cell(2,4) cell(2,5)
cell(3,2) cell(3,3) cell(3,4) cell(3,5)
cell(4,2) cell(4,3) cell(4,4) cell(4,5)

External/Internal Links

Math and LaTeX expressions

  • You can use either
    • The complete Math/LaTeX MediaWiki doc
    • In editing-mode, enter your TeX/LaTeX math expression and bound it by: <math>\sqrt{n}</math>
    • Or highlight any TeX/LaTeX expression and use the \(\sqrt{n}\) tool on the top of any editing-mode Wiki page to mark it specifically as LaTeX-interpreted. Once you save your new Wiki page the math expression should appear correctly rendered on the new Wiki page.
    • See examples here: http://wiki.socr.umich.edu/index.php/SOCR_EduMaterials_Activities_CLT

Wiki Page Internationalization

  • Remember that all SOCR Wiki pages should be made available in other languages using machine translations. This is accomplished via placing the following two lines at the bottom of your new document (you need to enter the new name of your SOCR Wiki page, as indicated). See the translation buttons below for examples of other languages that SOCR materials are automatically translated to: <hr>* SOCR Home page: http://www.socr.umich.edu<br> {{translate|pageName=http://wiki.socr.umich.edu/socr/index.php?title=NEW_SOCR_Page_MainTopic_SubTopic_SubSubTopic_NewTopic_Author_Date_Version}}. See the bottom of this page for example of how your language translation will look like.

Hints

  • Remember that the easiest way to construct a valid and well-designed SOCR Wiki page is the generate the materials, first, outside the SOCR Wiki. Make sure you are satisfied with the look-feel-content of your new materials, spell-ckeck the entire document (grammer, style, etc.) Finally, when you are happy with the content, you can quickly paste your text, figure, tables, links, expressions, diagrams, etc. in the SOCR Wiki page and make them available online to the community!



Translate this page:

(default)
Uk flag.gif

Deutsch
De flag.gif

Español
Es flag.gif

Français
Fr flag.gif

Italiano
It flag.gif

Português
Pt flag.gif

日本語
Jp flag.gif

България
Bg flag.gif

الامارات العربية المتحدة
Ae flag.gif

Suomi
Fi flag.gif

इस भाषा में
In flag.gif

Norge
No flag.png

한국어
Kr flag.gif

中文
Cn flag.gif

繁体中文
Cn flag.gif

Русский
Ru flag.gif

Nederlands
Nl flag.gif

Ελληνικά
Gr flag.gif

Hrvatska
Hr flag.gif

Česká republika
Cz flag.gif

Danmark
Dk flag.gif

Polska
Pl flag.png

România
Ro flag.png

Sverige
Se flag.gif