Help:Getting Started

From EyeWiki
(Redirected from Getting Started)

To contribute content[edit | edit source]

To directly post and edit content, you must be a qualified ophthalmologist or an ophthalmology resident in training and you will need to register with EyeWiki. Instructions for registering, and adding/editing content can be found below. If you are not an ophthalmologist or an opthalmology resident in training and would like to contribute to the site, see the guide below.

To register as an ophthalmologist or an ophthalmology resident in training[edit | edit source]

If you are a qualified ophthalmologist or an ophthalmology resident in training, you can create an account for contributing to EyeWiki by e-mailing the following information to eyewiki@aao.org

  • Full name
  • Ophthalmology subspecialty, e.g. Comprehensive, Retina
  • Degree type, e.g. MD, DO
  • Chosen password
  • E-mail address
  • Location, e.g. San Francisco, CA, USA
  • Affiliation, e.g. practice and/or educational institution
  • Financial disclosures. Please declare “none” if you have no financial disclosures to make

An EyeWiki administrator will contact you once your account is activated.

To contribute if you are NOT an ophthalmologist[edit | edit source]

If you are an ophthalmic scientist, medical student or working in field relating to ophthalmology, you can contribute to EyeWiki by collaborating with a sponsoring ophthalmologist already registered on the site.

While you won’t be able to edit EyeWiki directly, you can register for a read-only user account which will allow your sponsoring ophthalmologist to credit you as a co-author on articles that you have contributed to.

If you are not an ophthalmologist or resident in training, you can register for a read-only EyeWiki account by emailing eyewiki@aao.org with the following information:

  • Full name
  • Job title or field of work
  • Name of sponsoring ophthalmologist registered on EyeWiki
  • Chosen password
  • E-mail address
  • Location, e.g. San Francisco, CA, USA
  • Affiliation, e.g. practice and/or educational institution
  • Financial disclosures. Declare “none” if you have no financial disclosures to make

To add content (articles)[edit | edit source]

  • To add content to EyeWiki, first review the existing articles to see if a page has already been added for your subject. If the page does exist you can edit it to include your own input. Please review the Edit page section for additional instructions. *If a page does not already exist for your topic, follow the Add a new topic instructions below. You can review a list of suggested topics, too .
  • Note: The standard reference style to use is based on the AMA Manual of Style. Click here for reference style examples.

Add a new topic/new article[edit | edit source]

Use the field below to add a new topic. You will be taken to a page where you can add initial information and categorization.

Please check the existing list of articles or perform a search to ensure you do not duplicate an article topic already developed for EyeWiki.


What if I added an article by another method or an article is missing the ability to add the author and options to tag it to a subcategory?[edit | edit source]

To add an article to the EyeWiki categories, follow these steps:

  1. Go to the article in question  and click the "Edit" button.
  2. At the very bottom of the code for the page, insert {{Article}} and save the page.
  3. Now at the top of the page you should see an "Edit" tab. Click it and complete the form.

How do I rename a page?[edit | edit source]

To rename a page you can use the Move function. Go to the article and click on the Move link. A form will appear to allow you to make the change.

Move pages.png



Adding a Grand Rounds Presentation[edit | edit source]

1. Check out the grand rounds category page for some examples

2. Save your slides as individual jpeg images. In PowerPoint, choose file> save as and select .jpg as the format

Grand rounds how-to.png 

3. Upload the image files to EyeWiki. See the guide to adding files for details on how to do this.

4. Add a new grand rounds page by typing a name for the presentation into the grand rounds form below. Note that all grand rounds names should end in “(Grand Rounds)”, for example: "Carotid Cavernous Fistula (Grand Rounds)"

 

5. Add the presentation images into the appropriate sections on your new page. See the guide to adding images to a page for details on how to do this.

Additional Templates[edit | edit source]

You can replace the default template with one of these templates by cutting and pasting the Wiki code into your article. Use the Edit  (not Edit Source) mode and either use the Rich Editor's Wikitext mode or turn off the Rich Editor and paste the code. 

Edit page content, topic pages, etc.[edit | edit source]

Select the "edit" link at the top of the page you wish to edit. Whenever you make changes to a page, ensure you click the "Save page" button at the top of the screen to save your work. See the Content editing tips, below for more details on editing content in EyeWiki.

Content editing tips[edit | edit source]

Below, you can find information on Adding Files, Adding Images to Pages, and Adding YouTube Videos with an embedded player.

Adding/Uploading Files[edit | edit source]

You can add a file (image or document) to EyeWiki and then link to that file from any EyeWiki page. Note that you have to upload your file to EyeWiki before you can link to it.

1. Click on “Upload file” from “tool box" at the bottom of all EyeWiki pages:

Upload file.png

2. Click “Choose File” on the new page.
3. Find the file on your computer and press “Open”.
4. The name of the file will appear in this line, you can edit if you like.
5. You can add a description of the file in this line.
6. Click “Upload file”

Upload file2.png

7. Your file is now uploaded and can be added to EyeWiki pages.

Adding Links[edit | edit source]

There are two ways to enter links in EyeWiki articles:

  1. You can use the Visual Editor’s link function. Highlight the word or phrase that will be the link (Giant cell arteritis in this example) and click on the link button (see the red circle) in the Editor's menu. If you want to link to an internal EyeWiki article you can type the name of the article in the Link box and it will appear (Figure 1) or if you want to link to an external web address, type in the full address (such as http://www.cnn.com in Figure 2.)
  2. Or you can edit the Wikitext directly to ad the link. (For more information you can go to: here or here)
       a. For link to an article in the EyeWiki you would type [[Page title|Link label]] where Link Label is hyperlinked text that would appear in the article, if you do not include Link Label, the name of the page title would appear.
       b. For an external link you would type[http://www.example.org Link label] where Link Label is text that would appear in the article, if you do not include the Link Label the words http://www.example.org would simply appear in the article.


Figure 1.
Figure 1.

Figure 2.
Figure 2.

Adding Images to Pages[edit | edit source]

You are encouraged to add images to your articles as they help make content more engaging.

You can add an image that you have uploaded to EyeWiki, to any page within the wiki.

1. First you must be in edit mode on the page you would like to add the image to.
2. Click on the "insert" button and then select "media" from the drop down list.

Insert media.png

3. Type the name of the image you want to add to the page and it will start to search.
Image search.png

4. Once you see the image you're searching for, click on it.
6. The image will be inserted onto the page.
7. You can drag the image to a specific location on the page.
8. As with all edits you must click “Save page” for it to be saved to the live page.

Requesting Permission to Use American Academy of Ophthalmology Images or Text[edit | edit source]

If you would like to use images or text of the American Academy of Ophthalmology, please complete and submit this Request for Permission to the address listed in the form.


Adding Video (and Audio)[edit | edit source]

You are encouraged to add videos to your articles as they help make content more engaging.

You can add a video to Eyewiki that you have uploaded to Youtube:

1. Get the YouTube ID from the video on YouTube.com:

YouTubeID.jpg

2. Click "Edit source" on the page you want to add the video tube.


3. Add a Line in the page with the ID wrapped with the youtube tag, as shown here:

Youtube.png 

4. The YouTube video associated with the ID you entered will now be displayed on the page with its own player.


5. If you would like to add audio content only, please refer to this YouTube Help Article


Adding References and Avoiding Plagiarism[edit | edit source]

As a reminder is is critical to ensure articles are properly cited to avoid issues related to plagiarism. Specifically, materials that you contribute to the EyeWiki must be your original composition. The posting of materials copied from another source without permission will not be allowed. If you have any questions regarding what is appropriate, please contact one of our editors.

To add a citation in your article which will automatically populate endnotes, you can use icons within the Rich Editor, or wikitext tags:

To use the Visual Editor to add citations[edit | edit source]

1. Within the article, place your cursor where you want to cite a reference. Click "Insert" in the edit menu and then select "reference".

2. If the reference is new, type it into the text box.

3. If you want to cite a reference that you've previously cited in the article, select "Use an existing reference" and select if from the list.

4. Click "Insert reference" to add the citation.

New reference.png

5. Place your cursor at the end of the article, where you want your endnotes to appear. Click "Insert" in the edit menu and then select "reference list". EyeWIki will automatically organize the reference endnotes. Please note, you will only have to do this once for the article.  

Insert reference list.png

6. Don't forget to save your page after adding citations and references!

Note: You can add multiple references for one citation by adding one after the other, using the insert references method explained above.

To use Wikitext to add citations[edit | edit source]

1. Within the article, place your cursor where you want to cite a reference. Type the tag <ref> and then type your reference information. At the end of the reference information, type the tag </ref>. Do this for each citation.

2. Place your cursor at the end of the article, where you want your endnotes to appear. Type the tag </References> and your references will appear in order as you entered them in the article.  Please note, you will only have to do this once for the article.

Note: You can add multiple references for one citation by adding one after the other, each with their own REF tags. You can also name tags, and then reuse them as citations in your article with the <ref name ="tagname"> nomenclature.

For more information, see [1]


Reference Formats[edit | edit source]

Here are guidelines with regard to reference formats:

Reference List Examples
According to the AMA Manual of Style, 10th edition, references serve 3 primary purposes—documentation, acknowledgment, and directing or linking the reader to additional resources. Authors bear primary responsibility for all reference citations. Included here are examples of the style of various citations in a reference list. For additional examples and more information, refer to the AMA Manual of Style, 10th edition (New York: Oxford University Press; 2007).

Minimum Acceptable Data
Journals:
Print: Author(s). Article title. Journal Name. Year;vol(issue No.):inclusive pages.
Online: Author(s). Article title. Journal Name. Year;vol(issue No.):inclusive pages. URL. Accessed [date].

Books:
Print: Author(s). Book Title. Edition number (if it is the second edition or above). City, State (or Country) of publisher: Publisher’s name; copyright year.
Online: Author(s). Book Title. Edition number (if it is the second edition or above). City, State (or Country) of publisher: Publisher’s name; copyright year. URL. Accessed [date].

Web Site:

Author (or, if no author is available, the name of the organization responsible for the site). Title (or, if no title is available, the name of the organization responsible for the site). Name of the Web site. URL. Accessed [date].

Selected Examples

Journals:
Slade SG. The use of the femtosecond laser in the customization of corneal flaps in laser in situ keratomileusis. Curr Opin Ophthalmol. 2007;18(4):314-317. [journal names abbreviated per PubMed; journal name in italics]

Kezirian GM, Stonecipher KG. Comparison of the IntraLase femtosecond laser and mechanical microkeratomes for laser in situ keratomileusis. J Cataract Refract Surg. 2004;30(4):804-811.

Tran DB, Sarayba MA, Bor Z, et al. Randomized prospective clinical study comparing induced aberrations with IntraLase and Hansatome flap creation in fellow eyes: potential impact on wavefront-guided laser in situ keratomileusis. J Cataract Refract Surg. 2005;31(1):97-105. [up to 6 authors listed; if more than 6, list first 3 plus “et al”]

In German:

Geerling G, Duncker GI, Krumeich J, Melles GR. Lamellar keratoplasty. Back to the future? Ophthalmologe. 2005;102():1140-1151.

Books:

Buratto L, Brint S. Custom Lasik Surgical Techniques and Complications. Thorofare, NJ: Slack; 2003:3–8.

IntraLase FS™Laser Training Manual. Santa Ana, CA: Abbott Medical Optics; 2006:1–28.

Leigh RJ, Daroff RB, Troost BT. Supranuclear disorders of eye movements. In: Glaser JS, ed. Neuroophthalmology. Philadelphia, PA: Lippincott Williams & Wilkins; 1999:351–363.

Presentations:

Goldman D, Koreishi A, Yoo S, et al. Sutureless anterior lamellar keratoplasty (SALK) performed with a femtosecond laser. Federated Societies Scientific Session. Washington, DC: Eye Bank Association of America and the Cornea Society; 2006:15.

Academy Materials:

American Academy of Ophthalmology. Minimizing Transmission of Bloodborne Pathogens and Surface Infectious Agents in Ophthalmic Offices and Operating Rooms. Clinical Statement. San Francisco: American Academy of Ophthalmology, 2002.

Trobe JD. The Physician’s Guide to Eye Care, 3rd ed. San Francisco: American Academy of Ophthalmology; 2006.

Wilson FM, ed. Practical Ophthalmology, 6th ed. San Francisco: American Academy of Ophthalmology; 2009.

Web Site:

Feldman BH. Cataract. EyeWiki. http://eyewiki.aao.org/Cataract. Accessed June 21, 2011.

Understanding an article’s review status[edit | edit source]

EyeWiki editors and other registered site contributors may review articles and assign them a status based on the quality and completeness of the content.

Articles can be assigned as either:

  • “Up to Date”, which means the quality and accuracy of the content is generally high and the topic is covered in adequately detail.

or

  • “Update Pending”, which means the article requires further editing and/or the content is incomplete or requires more detail.

Note that there is no such thing as the perfect wiki article and all articles, even those marked as “good”, can benefit from further edits and new content.

How to assign a status to and article[edit | edit source]

1. Login to EyeWiki and go to the article page that you want to assign a review status to.

2. Click the "edit with form" link near the top of the page.

Edit with form.png

3. Enter your EyeWiki username in the reviewer field (this will normally be entered automatically).

4. Enter the date of the review (this will normally be entered automatically).

5. Select a review status from the drop-down menu.

6. Click "save page" at the bottom of the form.

Article review status.png

How to “watch” articles and categories for changes[edit | edit source]

In order to be notified about changes to an article or category of articles, proceed as follows:

1. Login to EyeWiki.

2. Navigate to the article page or category of articles page that you wish to be notified about. For example, eyewiki.aao.org/Category:Glaucoma.

3. Click on the “watch” link at the top of the page.

Watch a page.png

You can view recent changes made to the pages on your watchlist by clicking the "Watchlist" link in the top right of EyeWiki pages.

Portal pages[edit | edit source]

A list of all section portals is available here.

Query forms[edit | edit source]

  • Find all articles created within a certain time period by clicking here.
  • Find all articles that have not been edited since a certain date by clicking here.