Help:Visual editor

Visual editor is one of two options for editing MEpedia, the other being source editor.

How to use links
See MediaWiki's excellent How To Insert Links.

Inserting a new reference


For more information on the "Automatic" citations, see Visual Editor Auto-filled Web Citations.
 * 1) First, position the cursor at the end of the statement that requires a reference.  At the top of the window, click on the button that says 'Cite'.
 * 2) This will open a box with three tabs: "Automatic", "Manual", or "Re-use".
 * 3) If you are citing a reference that has already been added to the reference section, select the "Re-use" tab, select the reference from the list, and you're done!
 * 4) If you have the reference's website or DOI number, you can try the "Automatic" tab.  This is an automated reference machine that can sometimes create a correct reference from nothing more than a website or a DOI number.  Sometimes it works with a PMID number.  If it correctly finds and formats your reference, click "Insert" and you're done!
 * 5) If the "Automatic" tab is not able to generate the correct reference, you will have to use the "Manual" tab:
 * 6) When you click the "Manual" tab, you should see a drop-down menu that offers you options to cite a website, a book, a news article, or a scientific journal, as well as a "Basic form" for when all else fails.
 * 7) Mepedia journal cite 2.png Journal for any scholarly source. Scholarly sources are anything from Pubmed or a scientific journal online or in print.
 * 8) Use News for anything from a news outlet or a blog discussing the news. Note: if a news article or blog is discussing science, go back to the original source (the journal) and use the information you find in that original source.  Don't count on the writer of the blog to have gotten it right!
 * 9) Use Basic form when you aren't sure what category to use.
 * 10) When you choose to manually cite a journal, the pop-up box at right will be displayed: You will see places to fill in the information you know about the article.  Items with an asterisk next to them mean you must enter that information.
 * 11) Often, the journal citation will have information like page number or issue number. Scientific journals may also have multiple authors, even though there is room for only a few in the manual drop-down menu provided.  If you scroll down to the bottom and click the 'add more information' button (circled at right), then you will be able to add that information easily.
 * 12) If you see a field called "author link", you are encouraged to fill it in with the first and last name of the author. This will link the citation with the MEpedia page on that author.  See MEpedia:Author links for more information.
 * 13) When you are finished, click the blue 'Insert' button at the top right-hand side of the pop-up box.

Editing an existing reference
For information on editing existing references in the visual editor, see MediaWiki's Editing an Existing Reference.

How to use template tags
A ‘Template Tag’ is just a way to add a note to a page or to a statement.

To insert a template tag in the Visual Editor: For more information on template tags, see MEpedia:Templates.
 * 1) Click on "Insert" at the top of the window.
 * 2) Select "Template".
 * 3) Type in the name of the template tag (e.g. "Citation needed", "Cleanup", or "Stub").
 * 4) If you are inserting a "Cleanup" template tag, it will ask for additional information.  Describe the reason for the "Cleanup" template tag and provide the current date.
 * 5) Click "Add Template".

How to use categories
To change the categories that a page belongs to:
 * 1) Click on the 'Page Options' link represented by three horizontal bars towards the top-right of the screen.
 * 2) Click on 'Categories'.
 * 3) If you see an inappropriate category listed, you can remove that category by clicking on the garbage can icon for that category.
 * 4) You can type the name of any new category into the empty box labelled 'Add a Category'.
 * 5) Finally, click 'Apply Changes'.

Problems with long files
The Visual Editor has trouble when working with long files. In this case, the Visual Editor may take a long time saving changes, or it may hang completely.

If the Visual Editor stops working, follow these steps:
 * 1) Don't panic.  As long as your changes are visible in your web browser, your changes are not lost.
 * 2) Just to be safe, you can copy your changes to a word processing program until your changes are successfully saved.
 * 3) Wait 5-10 minutes, and try saving your changes again.
 * 4) If the problem persists, consider splitting the long page into 2 or more separate pages.

Learn more

 * MediaWiki's Visual Editor user guide