Wikidata

Wikidata:Zotero/Cita/Presentation workshop

< Wikidata:Zotero‎ | Cita

Preparation instructions edit

It is important that you prepare yourself for the workshop beforehand.

If you received an email confirming your pre-registration to the event, follow the steps below and submit the form at the end before Friday May 28 at 5pm UTC to confirm your seat and get the link for the meeting.

If you are going to watch the event on YouTube, you can also follow the preparation steps to get the best out of it. In that case, you can submit the form at the end as well to join the waiting list, in case a seat becomes available.

Install/Upgrade Zotero edit

Download and install Zotero.

If you already have Zotero installed, make sure you have a recent version (Cita has not been tested on Zotero versions prior to 5.0.94). To upgrade, go to Help > Check for Updates.

Install Cita edit

  1. Download the latest version of the .xpi file here.
     
    At the time of writing this, the latest version is 0.2.0 (but it could change)
  2. To install Cita, in Zotero go to Tools > Add-ons, and drag the .xpi file downloaded above into the "Add-ons Manager" window that opens. Click Install Now to confirm the installation.

Prepare your Zotero library edit

You will need at least 10 to 15 items in your Zotero library to work with during the workshop.

Cita should work with all item types supported by Zotero. However, Wikidata has more data on papers (journal articles). We recommend that you have some papers in your library for the workshop, ideally recent (as they are more likely to have a DOI and to be on Wikidata), and with some papers citing one another, to take full advantage of all Cita features.

Experienced users edit

If you are a Zotero user already, you probably have several items in your library. However, if you have only a few papers, you can read the New users section to add some.

On the other hand, although no critical bugs have been reported with Cita, we recommend that you make a backup copy of your Data Directory. To open this directory, in Zotero go to Edit > Preferences > Advanced > Files and Folders > Show Data Directory.

New users edit

  1. Install the Zotero Connector for your browser.
  2. Search for some journal articles on a topic you are interested in. You can use Google Scholar, PubMed, Scholia, among others.
  3. To add an article to Zotero from your browser, go to the article page (not the PDF):
    1. If the page is compatible, the icon of the Save to Zotero button on your browser toolbar should change indicating the item type detected (e.g., journal article). Click on it to add the item to your library.
       
    2. Instead, if the page is not compatible, the icon will change to that of a gray page. If you click on it, the item will be saved to your library as a generic webpage (not recommended).
       

Join Wikidata edit

Wikidata is a collaborative knowledge graph, with entities linked via properties. At the workshop we will edit Wikidata: we will link entities using the cites work (P2860) property, and we will create new entities.

Although the edits can be anonymous, you will need a Wikimedia account for the workshop:

  • If you already have an account on another Wikimedia project (e.g., Wikipedia) you don't need to create a new one for Wikidata, but we recommend that you log in to Wikidata at least once before the workshop.
  • If you don't have an account on any Wikimedia project, you can create one here.

Sign up on Dashboard edit

To help us estimate the impact of the workshop on Wikidata, please sign up to the event on Dashboard using your Wikimedia user.

Confirm you are ready edit

Submit this form confirming that you are ready for the event!

If you got an email confirming your pre-registration to the event, submit the form before Friday May 28 at 5pm UTC to confirm your seat and get the link for the meeting.

If you didn't pre-register for the workshop, or if you did but didn't get a seat, you can submit the form to join the waiting list. We will let you know if a seat becomes available. Anyway, remember that the event will be broadcasted live on YouTube.

During the workshop edit

Cita presentation workshop recording
 
Cita presentation workshop slides

Remember this workshop will be held under Wikimedia's Friendly space policies.

Exercise edit

If you don't remember how to do some of these steps, you can refer to Cita's quickstart guide, or go back in time on the YouTube's live event.

Preparation edit

  1. Update Cita to the latest version: in Zotero, go to Tools > Add-ons. Click on the little gear and then on Check for Updates.
  2. (Optional) Create a collection named "Cita workshop" and add between 10 and 100 items from your library. To create a collection, right click on the Collections Pane to the left and choose New Collection.
     
    New Collection

Get citations from Wikidata edit

  1. Fetch QIDs for the items in your collection. If none of the items selected has a QID, add others, or use the sample collection.
     
  2. Sync items with Wikidata to get citations.
     

Add citations and upload to Wikidata edit

  1. Choose an item with known QID and open the corresponding document. Find a missing citation and add it.
     
    Add citation
  2. Try to get the QID for the cited item. If no QID found, choose another citation, or create a new item in Wikidata (make sure it follows Wikidata's notability policy).
     
    Fetch QID
  3. Sync with Wikidata again to upload the new citation.
     

Citation graphs edit

  1. Show the Local Citation Network for your collection. You can take a screenshot to share in your social media networks.
     
  2. Find at least one suggested item and add it to your collection.

Sample collection edit

I suggest that you use your own Zotero library during the workshop. However, if you have trouble using Cita with your library, you can use the sample collection used in the demonstration:

  1. Download the .bib file here.
  2. In Zotero, go to File > Import.
  3. Select A file (BibTex, RIS, Zotero RDF, etc.) and click Next.
  4. Choose the .bib file you downloaded above.
  5. Check Place imported collections and items into new collection and click Next.
  6. The Sample collection collection should now appear in the Collections Panel to the left.

Contributing edit

Share edit

You can support the project sharing the tool and the workshop in your social media networks:

Some examples (but you certainly will come up with others much more creative):

Translation edit

Cita is collaboratively translated at translatewiki.net. Help translating to other languages here.

Documentation edit

Cita doesn't have any official documentation yet. You can help with writing it on the Cita's page, using this event's video as a reference.

Error reports and suggestions edit

If you find a bug or if you would like to suggest and improvement, post an issue at the Cita's repository on GitHub:

Version numbers edit

To get Zotero's version number, go to Help > About Zotero.

To get Cita's version number, go to Tools > Add-ons. In the window that opens, double click on Cita to show the version number.

Debug output log edit
  1. Enable logging: in Zotero, go to Help > Debug Output Logging > Enable.
  2. Follow the steps that lead to the bug you found.
  3. Go to Help > Debug Output Logging > View Output.
  4. On the window that opens, go to File > Save to save the log. Attach this file to your bug report.
  5. Close the Debug Output window and disable logging: Help > Debug Output Logging > Disable.
Installed add-ons edit
  1. Open the Add-ons manager: in Zotero, go to Tools > Add-ons.
  2. Take note of name and version of the add-ons installed and enabled.
Item or collection details edit

As long as this does not affect your privacy, you can export the item or collection causing trouble to a file to include in your bug report:

  1. Select the item(s) or collection causing trouble, right click on your selection and choose Export Item/Collection.
  2. Choose format Zotero RDF and make sure to check Export Notes (because Cita saves citations to a note attachment). Hit OK to save.

Support development edit

If you are a developer, you can contribute at the Cita's repository on GitHub. If not, you can also support maintenance and development by visiting the repository and making a donation.

Retrieved from "https://www.wikidata.org/w/index.php?title=Wikidata:Zotero/Cita/Presentation_workshop&oldid=1433437405"