User:Jeropbrenda/Sandbox/CitationWithCitoid

Overview
Citoid is a service that automatically creates a citation template given a URL, DOI, ISBN, PMID, PMCID or QID. It has a companion extension, Citoid, which makes use of VisualEditor's Citation Tool to provide the citoid service to VisualEditor.

This guide will cover how to use Citoid in VisualEditor to:


 * Add citations to a page.
 * Edit citations in a page.
 * Re-use citations in a page.

Prerequisites

 * VisualEditor's citation tool should be enabled in your wiki. If enabled, a "Cite" menu will be available in the toolbar. Instructions on how to enable the citation tool are available at VisualEditor/Citation tool




 * Citoid should be configured in your wiki. If configured, a "Cite" button will be available in your toolbar. If both the citation tool and Citoid are enabled, the "Cite" menu will be replaced by the "Cite" button. Instructions on how to configure citoid are available at Citoid/Enabling Citoid on your wiki



Add citations to a page
Click on the "Cite" button in the toolbar. This will open a dialog box with three tabs: Automatic, Manual, and Re-use.

Automatic
In the automatic field you can enter a variety of input and a citation template will be automatically generated. Most people input a URL (website address) but you can also enter a unique identifier like an ISBN for books, DOI (Digital Object Identifier), PubMed ID, PMCID (including the PMC prefix), or QID (from Wikidata). You can also enter a plain text fully formatted citation or title of the work. It helps to be as specific as possible, as we return only the first result from both Worldcat (which mostly contains books) and Crossref (which mostly contains academic papers) in a random order.



Manual
There are two types of footnotes that can be added from the Manual tab - using a standard template, or using the basic template.

Using standard cite templates

 * Your local wiki may have added extra citation templates to this menu. This offers quick access to the most-used citation templates. (Instructions for adding extra citation templates to your local wiki are available at VisualEditor/Citation tool.)




 * Clicking on a template icon such as "Cite book" will take you into the template mini-editor for that template. Important information fields may be marked with an asterisk. While the most common fields will be shown, not all of them are required.




 * To add more parameters, scroll down in the template mini-editor and click on the "Add more information" option.




 * Click on "Insert" when you're done.

Using the "Basic" citation

 * Clicking on "Basic form" will open a Reference editor, where you can add your citation, including formatting. You can make the reference belong to a given group, although normally this is left blank. (This option is used to display groups of references with the "References list" tool.)




 * In the Reference dialog, if you want to include a template in your new reference, click the Template icon (puzzle piece) in the "Insert" toolbar menu within the Reference editor.




 * Then, look for the template you want to use, add it and edit it as you would any other template. (See the Editing templates section, below, if you need more information about templates.)




 * After you're done editing your new template, click on "Apply changes" to return to the Reference editor, and "Apply changes" again to return to the page you're editing.