Creating an EyeWiki author account
Ophthalmologists, medical students and eye care professionals are eligible for EyeWiki author accounts. Ophthalmologists are able to create and edit articles. Non-ophthalmologists, i.e. medical students and eye care professionals, can partner with a sponsoring ophthalmologist to contribute content and be listed as an author, but they cannot directly edit EyeWiki pages. Sponsoring ophthalmologists will be contacted by EyeWiki staff to verify the partnership before account approval.
To request an account, visit the Create Account page. Note: EyeWiki contributors cannot create accounts for other users; you must create your own account.
You will be asked for the information listed below. All information is required before your account is activated. You MUST create a username (formatted as Firstname.Surname) and password AND please FILL OUT YOUR USER PAGE by providing the information requested.
EyeWiki staff will review your account details and approve eligible accounts. You will NOT be immediately able to author or edit on EyeWiki when you submit your account details. EyeWiki staff must review and approve all account requests before you have full access.
Information required for ophthalmologists or ophthalmology residents in training
You must provide the following information on the Create Account page and profile page that follows.
- 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 - name the specific institution
- Financial disclosures. Please declare “none” if you have no financial disclosures to make
Information required for non-ophthalmologists
If you are an ophthalmic scientist, medical student or working in a field related to ophthalmology, you can contribute to EyeWiki by collaborating and partnering with a sponsoring ophthalmologist already registered on the site. Please note that your account will not be approved until EyeWiki staff have verified the partnership directly with the sponsoring ophthalmologist. After your account is approved, you will have a read-only user account. Although you will not be able to edit articles directly, your sponsoring ophthalmologist will be able to credit you as a co-author.
You must provide the following information on the Create Account page and profile page that follows:
- Full name
- Job title or field of work
- Name of sponsoring ophthalmologist registered on EyeWiki who we will contact to verify sponsorship
- 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
Logging in properly
If you encounter issues with EyeWiki, please follow these steps to confirm that you can log in properly:
- Go to the main page of EyeWiki and click the Log in link at the top right hand corner of the page
- Click the blue Accept button at the bottom of the page
- Check off the ‘Keep me logged in’ checkbox to reduce potential lost work from session expiry.
- Enter your case-sensitive username: Firstname.Lastname and your password
- If successful, your username will appear at the top of page
- If login was not successful, your username does not appear at the top or there was an error, please send a screenshot(s) describing the issue noting the page title, date and time of the occurrence to eyewiki@aao.org
- Updating your browser version, clearing browser cache, closing multiple browser tabs with open EyeWiki sessions, saving page changes often and/or logging out and back in again may help reduce further issues with site issues, e-mail address reconfirmation or expired session login verification.
Updating and managing your EyeWiki account
You control the personal details that are displayed in your profile. To update your profile, log in to EyeWiki, then click on your name in the upper right part of any page.
To update your email preferences, visit the email preferences page.
To add content (articles)
- 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.
- NOTE: Articles that are added and have no content or are very incomplete may be deleted after 30 days of inactivity. Please do not add articles unless you plan to complete them within 30 days.
Add a new topic/new article
Article title considerations
- EyeWiki uses Title Case
- Is the article title concise, consistent and specific?
- Is the title found in reliable sources such as ICD, SNOMED CT, Medical Subject Headings or other controlled vocabularies?
- Observe community standards to guide article naming
- Any qualifiers or short description text can be added under the Meta Description of the article instead of lengthening the article title. Simply click on Edit with Form to enter a short description in the Meta Description field
- Article titles are subject to revision for editorial consistency
Examples:
- Lacks title case, unnecessary qualifier
Laser peripheral iridotomy - a glaucoma surgery- Preferred: Laser Peripheral Iridotomy
- Not concise
The use of non-penetrating deep sclerectomy for the treatment of primary and secondary open angle glaucoma- Preferred: Deep Sclerectomy
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 complete search to ensure you do not write an article that significantly overlaps or duplicates an article already on EyeWiki. EyeWiki editors regularly review and delete such articles. If the topic you want to write about is already on EyeWiki please consider updating an existing article, so your contributions may be recognized.
Choose a template:
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?
To add an article to the EyeWiki categories, follow these steps:
- Go to the article in question and click the "Edit source" button.
- At the very top of the code for the page, insert {{Article}} and save the page.
- Now at the top of the page you should see an "Edit with form" tab. Click it and complete the form.
How do I rename a page?
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.
Edit page content, topic pages, etc
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 changes..." button at the top of the screen to save your work.
Users collaborating on articles can also create or edit in plain text which is compatible with email programs, text editors and other word processing programs.
When updating articles in plain text using Edit source, the standard template defines section headings surrounded by equal signs. For example, one equal sign surrounding text denotes a top level section heading; two equal signs denotes a sub level and so on.
= Disease Entity = Add text here == Disease == Add text here == Etiology == Add text here
A table of contents is automatically generated when more than three section headings are used. Article drafts can be updated incrementally without filling in all of the sections using Edit or Edit source as needed. Again, ensure you click the "Save changes" button to save your work.
See Content Template Example for a full example and Content editing tips, below for more details on editing content in EyeWiki.
Content editing tips
Below, you can find information on Adding Files, Adding Images to Pages, and Adding YouTube Videos with an embedded player.
Adding/Uploading Files
You can add a file (image or video) 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:
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 and associated source.
6. Click “Upload file”
7. Your file is now uploaded and can be added to EyeWiki pages.
Adding Links
There are two ways to enter links in EyeWiki articles:
- 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 https://www.aao.org in Figure 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[https://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 https://www.example.org would simply appear in the article.
Figure 1.
Figure 2.
Adding Images to Pages
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 "Images and media" from the drop down list.
3. Type the name of the image you want to add to the page and it will start to search.
4. Once you see the image you're searching for, click on it.
5. The image will be inserted onto the page.
6. You can drag the image to a specific location on the page.
7. As with all edits you must click “Save page” for it to be saved to the live page.
Adding a gallery of images
A series of images may be inserted within a gallery
- Upload images that you want in your gallery series
- Navigate to the article and click Edit to open the VisualEditor
- Position the cursor at the location of text where the gallery of images will be inserted
- Under the Insert menu click More then Gallery
- Enter a search term to find images in the series you uploaded. You may also search for the uploaded images by checking your Contributions at the top of the page
- Select the image and enter a caption, alternative text (to aid accessibility) or remove image as needed
- Continue clicking Add a new image and repeating the steps above for each image in the series
- Under the Gallery > Options tab, a caption for the whole gallery may be added and the display mode set to Slideshow under the drop down menu
Editing a gallery of images
- Click Edit to enter Visual Editor mode
- Find and select the pre-existing gallery element and click Edit
- Click Add a new image to add new images to the gallery
- Remove image(s) from the gallery by selecting the image(s) from the right panel, scroll to the bottom of the image detail screen and click the Remove Image button
Requesting Permission to Use American Academy of Ophthalmology Images or Text
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.
Images in the Academy's Image Collection in the clinical education section are pre-approved for use on EyeWiki, as long as images are properly credited to the Academy according to the guidelines that you will find in the image collection area. Visit the image collection and use the image-specific search box to find an image that is appropriate to your article.
Adding Video (and Audio)
You are encouraged to add videos to your articles as they help make content more engaging.
- For videos larger than 200MB please see Add videos from YouTube
- For videos smaller than 200MB please see Add a local video
Add videos from YouTube
You can add a video to Eyewiki that you have uploaded to Youtube:
1. Get the YouTube ID from the video on YouTube.com:
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:
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.
YouTube video example as rendered
Source: YouTube. American Academy of Ophthalmology. Hypertension and the Eye. https://youtu.be/SUn8wTtvfL4 Accessed June 8, 2020.
Add local video
Please note using this method the maximum file size is 200 MB AND the permitted file types for video are avi, ogv, mp4, m4v, webm. Video files may be added with either Edit with form, Edit source or Edit (Visual Editor)
Using Edit with form
- Upload the video file via Edit with form for any article under the Local Videos section
Using the LocalVideo template (quick and easy way by Edit source)
- Upload your video file following the instructions at Adding/Uploading Files
- Make a note of the filename of the uploaded video
- Go to the article where the video is to be inserted
- Choose Edit source and click on the location of the content where the video is to be inserted
- Enter the following template (either form is acceptable) as plain text in the body of the article
- where File page is the name of the video uploaded
- and Caption is the caption of the video
- Take care not to embed the LocalVideo template in another template such as the InfoBox template as the video will be hidden on mobile devices.
{{LocalVideo|
|File page = Eyewiki_test.mp4
|Caption = Angiography blood flow
}}
OR
{{LocalVideo|File page=Eyewiki_test.mp4|Caption = Angiography blood flow}}
Inserted video example as rendered
Angiography blood flow
Add a local video using the LocalVideo template (Visual Editor)
- Upload your video file following the instructions at Adding/Uploading Files
- Make a note of the filename of the uploaded video
- Go to the article where the video is to be inserted
- Choose Edit and click on the location of the content where the video is to be inserted
- Choose Insert > Template and in the Add a Template dialog (see below), add fields: File page AND Caption with their associated values
- Refer to screenshots below as a guide. Need more help? Please email eyewiki@aao.org
1. Add the LocalVideo template: enter LocalVideo in the search field and select Add template
2. Add the File page field: enter File page and click on the grey box Unknown field to insert this new File page field. Then Add the uploaded video filename to the File page field: enter the uploaded video filename for the File page field
3. Click Add more information to add the caption field and caption of the video: add a Caption field and value just like the steps for the File page
4. Once you have 2 fields: File page AND Caption with their associated values, click Insert to add the LocalVideo template.
Adding References and Avoiding Plagiarism
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 add citations
1. Within the article, place your cursor where you want to cite a reference. Click "Cite" in the edit menu and then select "Basic" to add a new reference or "Re-Use" to place another reference to something that you've already cited.
2. If the reference is new, type it into the text box.
3. You can also cite a reference that you've previously cited in the article by selecting "Cite" in the edit menu and then select "Re-use". Scroll or search for the existing reference in pop-up dialog with a list of references and click on the one to re-use.
4. 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.
6. Save your page.
Note: You can add multiple references for one citation by adding one after the other, using the Re-use method explained above.
To use Wikitext to add citations
1. You must be in "Edit Source" mode to create citation tags using this method.
2. 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.
3. 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. 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
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:
American Academy of Ophthalmology. Saccades and fixations. https://www.aao.org/image/saccades-fixations Accessed May 27, 2020.
Dixit S. American Academy of Ophthalmology. Fallen beauty, traumatic Iridodialysis. https://www.aao.org/image/fallen-beauty-traumatic-iridodialysis Accessed April 29, 2021.
Feldman BH. Cataract. EyeWiki. https://eyewiki.aao.org/Cataract. Accessed June 21, 2011.
Using Discussion or Talk pages
- Discussion pages, also known as Talk pages can be used to collaborate on articles by entering comments
- Get started by clicking the Discussion link, available on any article page and add your comments with simple formatting to get your thread going.
Understanding an article’s review status
EyeWiki editors are responsible for reviewing articles and assigning 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 adequate detail.
or
- “Update Pending,” which means the article requires further editing or the content is incomplete or requires more detail.
Note that there is no such thing as the perfect wiki article and all articles benefit from further edits and new content.
How to assign a status to an article
Authors should NOT review or assign status to their own articles. Article review for new and newly revised articles is conducted by our subject editors.
- Login to EyeWiki and go to the article page that you want to assign a review status to.
- Click the "edit with form" link near the top of the page.
- If you are section lead editor, enter the name of the assigned editor here. If you are an assigned editor, your name should appear here. To find someone, start typing their name. EyeWiki will display possible matches based on username.
- Enter the date of the review.
- After you have reviewed or edited an article, select a review status from the drop-down menu.
- Up to date: Indicates the article is clinically current and needs no changes as of the current date. Even if you did not make changes, please add the current date so the article is removed from the queue.
- Update pending: Indicates the article needs work. Use this status only if you have not updated the article for some reason, e.g. you are assigning it to a colleague or to another user to update. If you choose to assign the article to another user, please ensure that they have an EyeWiki account. Enter their name in the “Reviewer” field, and delete any other names in that field. To find someone, start typing their name. EyeWiki will display possible matches based on username.
- Click "save page" at the bottom of the form.
How to “watch” articles and categories for changes
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.
You can view recent changes made to the pages on your watchlist by clicking the "Watchlist" link in the top right of EyeWiki pages.
Citing Your Contributions to the EyeWiki
Many authors have asked what format to use when citing their contributions to the EyeWiki in their CV. Our recommended format is below.
Marcet MM. Sebaceous Carcinoma. American Academy of Ophthalmology, EyeWiki. February 2011. https://eyewiki.aao.org/Sebaceous_carcinoma. Accessed March 25, 2014.
Portal pages
A list of all section portals is available here.
