Updating and creating notes on WikEM: Difference between revisions

(Reverted edits by Dave7764 (talk) to last revision by Ostermayer)
(42 intermediate revisions by 9 users not shown)
Line 10: Line 10:
*Feel free to divide notes into several notes, or combine them if it makes them more useful  
*Feel free to divide notes into several notes, or combine them if it makes them more useful  


== Creating a New Note ==
==Creating a New Note==
#'''YOU MUST FIRST LOGIN'''  
#'''YOU MUST FIRST LOGIN'''  
#*See [[Create an Account]]  
#*See [[Create an Account]]  
Line 16: Line 16:
#'''Search for the term''' in the search field in the upper right hand corner of the page  
#'''Search for the term''' in the search field in the upper right hand corner of the page  
#*If you find a note with a similar theme, please edit it instead with your new content (see below) rather than making a duplicate page
#*If you find a note with a similar theme, please edit it instead with your new content (see below) rather than making a duplicate page
#*If you don't find a note on your subject, click on the link: '''"Create the page on this wiki!"'''  
#*If you do not find a note on your subject, click on the link: '''"Create the page on this wiki!"'''  
#**Use the Boilerplate (Template) function for your type of note (see Templates below)
#**Use the Boilerplate (Template) function for your type of note (see Templates below)
#Please follow [http://en.wikipedia.org/wiki/Wikipedia:Tutorial/Formatting formatting guidelines] below
#Please follow [http://en.wikipedia.org/wiki/Wikipedia:Tutorial/Formatting formatting guidelines] below
Line 22: Line 22:


==Editing Notes==
==Editing Notes==
<big>*Please read the '''[http://en.wikipedia.org/wiki/Wikipedia:Tutorial/Formatting wikipedia tutorial:]'''</big>
===General Instructions===
#First search (upper right hand corner; login first) for the note that you want to edit
#First search (upper right hand corner; login first) for the note that you want to edit
#Once on the relevant page, click on the Edit button in the top right-hand corner to edit the page
#Once on the relevant page, click on the Edit button in the top right-hand corner to edit the page
#*'''If you do not see the edit button, you are probably not logged in!''' (login to see it)
#*'''If you do not see the edit button, you are probably not logged in!''' (login to see it)


==Basic Formatting==
<big>*Please read the '''[http://en.wikipedia.org/wiki/Wikipedia:Tutorial/Formatting wikipedia tutorial:]'''</big>
===Headings===
===Headings===
*<nowiki>==Heading 1==</nowiki>
*<nowiki>==Heading 1==</nowiki>
Line 34: Line 33:
*<nowiki>====Heading 3====</nowiki>
*<nowiki>====Heading 3====</nowiki>


===Bullet points (Prefered)===
===Bullet points (Preferred)===
*<nowiki>*Level 1</nowiki>
*<nowiki>*Level 1</nowiki>
**<nowiki>**Level 2</nowiki>
**<nowiki>**Level 2</nowiki>
Line 40: Line 39:
****<nowiki>****Level 4</nowiki>
****<nowiki>****Level 4</nowiki>


===Outline numbers (Less preffered than bullet points; see above)===
===Outline numbers (Less preferred than bullet points; see above)===
#<nowiki>#Level 1</nowiki>  
#<nowiki>#Level 1</nowiki>  
##<nowiki>##Level 2</nowiki>
##<nowiki>##Level 2</nowiki>
Line 46: Line 45:
####<nowiki>####Level 4</nowiki>
####<nowiki>####Level 4</nowiki>


===Category ===
===Category===
*<nowiki>[[Category:NameOfCategory']] </nowiki>
*<nowiki>[[Category:NameOfCategory']] </nowiki>
*See list of [[categories]]
*See list of [[categories]]
Line 57: Line 56:
*External link with different label: <nowiki>[http://mediawiki.org MediaWiki]</nowiki>
*External link with different label: <nowiki>[http://mediawiki.org MediaWiki]</nowiki>


===Images===
==References==
*Upload image in .jpg or .png format using the "Upload file" on the left. All images should be "creative commons" licensed
*<nowiki>[[File:File.jpg]]</nowiki>to use the full version of the file
*<nowiki>[[File:File.png|200px|thumb|left|alt text]]</nowiki> to use a 200 pixel wide rendition in a box in the left margin with 'alt text' as description
*<nowiki>[['''Media:File.ogg''']]</nowiki>for directly linking to the file without displaying the file
 
===Footnote Referencing===
===Footnote Referencing===
*Add the tags <code>&lt;ref></code>and <code></ref></code>on either side of the journal citation
*Add the tags <code>&lt;ref></code>and <code></ref></code>on either side of the journal citation
*Place the tag <code>&lt;references/></code> at the bottom of the article in the Sources Section for auto-generated footnotes
*Place the tag <code>&lt;references/></code> at the bottom of the article in the Sources Section for auto-generated footnotes
*References follow a 1 author [http://www.lib.jmu.edu/citation/amaguide.pdf AMA style]: Spencer J. et al. Physician, heal thyself – but not on your own please. Med Educ. 2005; 89: 548-549.
*References should utilize primary literature whenever possible.
*Secondary and Tertiary (textbook) sources are permitted however they must be clearly referenced and follow the [http://www.lib.jmu.edu/citation/amaguide.pdf AMA style guide].


====Multiple Footnotes of Same Source====
====Multiple Footnotes of Same Source====
To give a footnote a unique identifier, use '''&lt;ref name="name">'''. You can then refer to the same footnote again by using a ref tag with the same name. The text inside the second tag doesn't matter, because the text already exists in the first reference. You can either copy the whole footnote, or you can use a terminated empty ref tag that looks like this: '''&lt;ref name="name" />'''. The quotes are not required (but still correct) if the name contains no embedded spaces. The space before the closing "/" may be omitted.
To give a footnote a unique identifier, use '''&lt;ref name="name">'''. You can then refer to the same footnote again by using a ref tag with the same name. The text inside the second tag does not matter, because the text already exists in the first reference. You can either copy the whole footnote, or you can use a terminated empty ref tag that looks like this: '''&lt;ref name="name" />'''. The quotes are not required (but still correct) if the name contains no embedded spaces. The space before the closing "/" may be omitted.
 
==Images==
===Finding Images===
*You can use most images from Wikipedia
*Search the web with [http://openi.nlm.nih.gov/ OPENi-An Open Access Biomedical Image Search Engine]
 
===To upload an image to WikEM===
*Log-in
*Click on the link [[Special:Upload]] which appears under 'Toolbox' in the links on the left
**Please cite the source of the image in the "Summary" section. (source webpage or article if from OPENi-An, website e.g. Wikimedia Commons, etc)
**If not from commonly used source (OPENi-An, Wikipedia, Wikimedia Commons), please also note the image license, if known (should be Creative Commons or similar)
 
===To inset an image into a page===
*Within the relevant file insert the following:
**Our standard '''<nowiki>[[File:Image-file-name.jpg|thumb|Writing that you want on the bottom of the photo]]</nowiki>'''
 
===Other===
*To see a list of uploaded images by WikEM users see [[Special:ListFiles]]
*To direct link to the file without displaying the file use: '''<nowiki>[['''Media:File.ogg''']]</nowiki>'''
 
==Tables==
*Make a table in excel and copy all the cells
*Paste it into: http://wang.wustl.edu/mediawiki/extensions/index.php
*Then paste the text into the wiki page you are editing
 
==Redirects==
To make a redirect from some search term (e.g. Zofran) to a note (e.g. Ondansteron)
*Create a new page for "Zofran" (see above on how to create a new page)
**In the new page type the redirect code (and only the redirect code): '''<nowiki>#REDIRECT[[DestinationPageName]]</nowiki>'''
***Example:  '''<nowiki>#REDIRECT[[Ondansteron]]</nowiki>'''
 
==Templates in Text (Transposition)==
*Used to have the same text on multiple pages
**Used frequently in the Differential Diagnosis sections and then placed on the respective pages
*To make a template, place {{ symbol around it in the text
**Example: '''<nowiki>{{Template page name}}</nowiki>'''
*To search for template, use "Template:" before the template page name in the search bar (e.g. "Template:Template page name")
*'''There is a known issue with the template not immediately appearing on edited pages due to catching. Please give it a couple of minutes and it will eventually appear.'''
 
==Boilerplate Templates==
*You can auto-generate Boilerplate Templates when creating a new note (click on function at top of new note page)
*Contributors are encouraged to update old pages to the current templates, when applicable
*Current templates are:
**[[Template:Standard|Standard Template]]
**[[Template:JCReview|Journal Club Review]]
**[[Template:Quiz|Quiz Set]]
**[[Template:GEMC|GEMC]]
***Directions at *[[Template Directions (GEMC)]]
**[[Template:Medication|Medication Template]]
**[[Template:Procedure|Procedure Template]]
**[[Template:ResidencyPage|Residency Page Template]]
 
*Boilerplate source (for adding new templates) is at [[MediaWiki:Multiboilerplate]]


===Quizes===
==Quizzes==
{| class="prettytable"
{| class="prettytable"
!wikitext!!rendering!!comments
!wikitext!!rendering!!comments
Line 104: Line 154:
|}
|}
|valign="top"|
|valign="top"|
* Feedback is text which is initially hidden, and then shown to the user when they submit the quiz for correction. Feedback typically serves the purposes of encouragement, explanation, congratulation and commiseration.
*Feedback is text which is initially hidden, and then shown to the user when they submit the quiz for correction. Feedback typically serves the purposes of encouragement, explanation, congratulation and commiseration.
* Feedback is set with all types by using a double vertical line '''||''' immediately after a response.  
*Feedback is set with all types by using a double vertical line '''||''' immediately after a response.  
* The pipes beginning the ''feedback'' section must be on a new line.
*The pipes beginning the ''feedback'' section must be on a new line.
* Unlike some other quiz systems, '''all''' feedback items are displayed on correction. With other quiz systems, the norm is to display the feedback only for those items which were selected by the user.
*Unlike some other quiz systems, '''all''' feedback items are displayed on correction. With other quiz systems, the norm is to display the feedback only for those items which were selected by the user.
* To try out the feedback effect, choose a response and click the correction button. The feedback will then appear.
*To try out the feedback effect, choose a response and click the correction button. The feedback will then appear.
|}
|}


==Boilerplate Templates==
==See Also==
*You can auto-generate Boilerplate Templates when creating a new note (click on function at top of new note page)
*Contributors are encouraged to update old pages to the current templates, when applicable
*Current templates are:
**[[Template:Standard|Standard Template]]
**[[Template:JCReview|Journal Club Review]]
**[[Template:Quiz|Quiz Set]]
**[[Template:GEMC|GEMC]]
***Directions at *[[Template Directions (GEMC)]]
**[[Template:Medication|Medication Template]]
**[[Template:Procedure|Procedure Template]]
 
*Boilerplate source (for adding new templates) is at [[MediaWiki:Multiboilerplate]]
 
== Images  ==
*To upload an image to WikEM
**Log-in
**Click on the link [[Special:Upload]] which appears under 'Toolbox' in the links on the left
***The page also includes directions for how to use the images once uploaded
***Please be considerate of the Style Guidelines
***For formatting of the file (resizing, thumbnails, etc..) please refer to http://www.mediawiki.org/wiki/Help:Images#Linking_to_an_image_without_displaying_it
*To see a list of uploaded images by WikEM users see [[Special:ListFiles]]
 
== Standardized Abbreviations  ==
*CXR Chest X-Ray / Radiograph
*DM Diabetes Mellitus
*HTN Hypertension
*DDx Differential Diagnosis
 
==Tables==
*Use http://excel2wiki.net/
**Then, change first line to:  {| class="wikitable"
*Can see WikiMedia [[Template:Table|special Notation]]
 
== See Also ==
*[[Helping out on WikEM]]
*[[Helping out on WikEM]]
*[[Resident Editors]]
*[[WikEM editorial levels]]
*[[Needed Pages]]
*[[Needed Pages]]


[[Category:WikEM]]
[[Category:WikEM]]

Revision as of 17:31, 8 June 2017

Getting Started

Thanks for wanting to help out on WikEM! People are the core of the wiki. Your knowledge translates into improved bedside practice for everyone.

To get started

If you are looking for ways to contribute

Also

General Guidelines

  • Keep entries concise yet informative
    • Preference is for notes, not chapters (i.e. think Pepid, not UpToDate)
  • Remember that the most common user format is the smart phone (view it on your phone to see the final format)
  • Focus on practical knowledge. Describe pathophysiology only when necessary for bedside treatment.
  • Reference other notes whenever possible
  • Put your source(s) in a "Sources" section or use the Footnote Referencing function
  • Feel free to divide notes into several notes, or combine them if it makes them more useful

Creating a New Note

  1. YOU MUST FIRST LOGIN
    • See Create an Account
      • You must confirm your email address (check your email account) before the site will give you the ability to make changes.
  2. Search for the term in the search field in the upper right hand corner of the page
    • If you find a note with a similar theme, please edit it instead with your new content (see below) rather than making a duplicate page
    • If you do not find a note on your subject, click on the link: "Create the page on this wiki!"
      • Use the Boilerplate (Template) function for your type of note (see Templates below)
  3. Please follow formatting guidelines below
  4. Put a category at the end of the entry

Editing Notes

  1. First search (upper right hand corner; login first) for the note that you want to edit
  2. Once on the relevant page, click on the Edit button in the top right-hand corner to edit the page
    • If you do not see the edit button, you are probably not logged in! (login to see it)

Basic Formatting

*Please read the wikipedia tutorial:

Headings

  • ==Heading 1==
  • ===Heading 2===
  • ====Heading 3====

Bullet points (Preferred)

  • *Level 1
    • **Level 2
      • ***Level 3
        • ****Level 4

Outline numbers (Less preferred than bullet points; see above)

  1. #Level 1
    1. ##Level 2
      1. ###Level 3
        1. ####Level 4

Category

  • [[Category:NameOfCategory']]
  • See list of categories

Internal Links

  • [[NameOfLinkedToNote]]

External Links

  • Standard: http://mediawiki.org
  • External link with different label: [http://mediawiki.org MediaWiki]

References

Footnote Referencing

  • Add the tags <ref>and </ref>on either side of the journal citation
  • Place the tag <references/> at the bottom of the article in the Sources Section for auto-generated footnotes
  • References follow a 1 author AMA style: Spencer J. et al. Physician, heal thyself – but not on your own please. Med Educ. 2005; 89: 548-549.
  • References should utilize primary literature whenever possible.
  • Secondary and Tertiary (textbook) sources are permitted however they must be clearly referenced and follow the AMA style guide.

Multiple Footnotes of Same Source

To give a footnote a unique identifier, use <ref name="name">. You can then refer to the same footnote again by using a ref tag with the same name. The text inside the second tag does not matter, because the text already exists in the first reference. You can either copy the whole footnote, or you can use a terminated empty ref tag that looks like this: <ref name="name" />. The quotes are not required (but still correct) if the name contains no embedded spaces. The space before the closing "/" may be omitted.

Images

Finding Images

To upload an image to WikEM

  • Log-in
  • Click on the link Special:Upload which appears under 'Toolbox' in the links on the left
    • Please cite the source of the image in the "Summary" section. (source webpage or article if from OPENi-An, website e.g. Wikimedia Commons, etc)
    • If not from commonly used source (OPENi-An, Wikipedia, Wikimedia Commons), please also note the image license, if known (should be Creative Commons or similar)

To inset an image into a page

  • Within the relevant file insert the following:
    • Our standard [[File:Image-file-name.jpg|thumb|Writing that you want on the bottom of the photo]]

Other

  • To see a list of uploaded images by WikEM users see Special:ListFiles
  • To direct link to the file without displaying the file use: [['''Media:File.ogg''']]

Tables

Redirects

To make a redirect from some search term (e.g. Zofran) to a note (e.g. Ondansteron)

  • Create a new page for "Zofran" (see above on how to create a new page)
    • In the new page type the redirect code (and only the redirect code): #REDIRECT[[DestinationPageName]]
      • Example: #REDIRECT[[Ondansteron]]

Templates in Text (Transposition)

  • Used to have the same text on multiple pages
    • Used frequently in the Differential Diagnosis sections and then placed on the respective pages
  • To make a template, place {{ symbol around it in the text
    • Example: {{Template page name}}
  • To search for template, use "Template:" before the template page name in the search bar (e.g. "Template:Template page name")
  • There is a known issue with the template not immediately appearing on edited pages due to catching. Please give it a couple of minutes and it will eventually appear.

Boilerplate Templates

Quizzes

wikitext rendering comments
 {Question
 |type="()"}
 + The correct answer.
 || Feedback for correct answer.
 - Distractor.
 || Feedback for distractor.
 - Distractor.
 || Feedback for distractor.
 - Distractor.
 || Feedback for distractor.

Question

The correct answer.
Distractor.
Distractor.
Distractor.

  • Feedback is text which is initially hidden, and then shown to the user when they submit the quiz for correction. Feedback typically serves the purposes of encouragement, explanation, congratulation and commiseration.
  • Feedback is set with all types by using a double vertical line || immediately after a response.
  • The pipes beginning the feedback section must be on a new line.
  • Unlike some other quiz systems, all feedback items are displayed on correction. With other quiz systems, the norm is to display the feedback only for those items which were selected by the user.
  • To try out the feedback effect, choose a response and click the correction button. The feedback will then appear.

See Also