How to contribute I: Wiki and References

Summary

This page collects all the best practices in order to keep a coherent and tidy wiki

Distinguishing quotations and original text

Because much of the information that is stored in this wiki will potentially be used in academic articles, it is paramount that a clear distinction is made between what is copy/pasted from other references (quotations) and what is original text written by one of the contributors to the wiki. In order to distinguish the two, the following simple formatting should be followed.

Original text

Original text appears without any specific formatting, as in this sentence.

Copy/pasted material

All copy/pasted material should be formatted as "Block Quote". This can be achieved in two ways

• In the visual editor (when clicking "edit"), chose the text that you just copy pasted, select "Paragraph" and in the drop down menu chose "block quote". Then "Save page..." in the upper right corner. The test should appear as follows:
• Alternatively, in the regular editor ("edit source") or in the form editor ("edit form") include the copy/pasted text within the following codes: <blockquote> </blockquote> Then "Save page..." in the upper right corner. In either cases, the text should appear as follows:

The Face Recognition Technology (FERET) dataset was thus created with $6.5 million of funding from the U.S. Department of Defense and the National Institute of Standards and Technology (NIST) to provide researchers the data they required to make progress in the field. In 15 photography sessions of the same set up between August 1993 and July 1996, images were collected in a semi-controlled environment

How to cite sources

When additing information in original text, or through copy/pasted material, Every entry in the wiki should be referenced. References are all stored in the shared Zotero database. Because there is currently no direct way to connect the wiki to Zotero, this connection has to be made manually. Here are the steps that should be taken:

1. Import the reference in Zotero.

This step is simple, and can be done manually or through the Zotero picker installed in your browser.

2. Create and pin a Better BibteX Citation Key

Once a refernce is created in Zotero, you will need to create a unique identification key for this reference. This key will then be imported in the wiki.

1. Make sure that the fields "Author", "Title" and "Year" are correctly and accurately entered for your reference.
2. Zotero's Better BibTeX add-on will automatically generate a Citation Key, which you will see in the right pane. The citation key is generated on the basis of the fields "Author", "Title" and "Year". Unless the citation is "pined" changing these fields will change the key. We want to avoid that, we must thus lock the citation key.
3. You can do that by "Pinning" that Citation Key in Zotero. Right click the citation in Zotero, in the drop down menu chose "Better BibTeX", then "Pin BibTeX key". A red pin will then appear next to your citation key.
4. Copy the citation key.

3. Use the citation key to reference text in the Wiki

Now go back to your wiki page were you want to create a reference. You can do one of the following:

• In the visual editor (when clicking "edit"), chose the link icon (between A and "Cite") and type (be carefull, it is case sensitive): "CiteRef::" followed by the citation key you copied from Zotero. Click "Done". Click "Save page..." or "Save changes..." in the upper right corner.
• In the regular editor (when clicking "edit source"), you can just add the reference with the curent syntax: 1

What links here

• How to contribute II: Creating a New Deployment ‎ (← links)
• How to contribute III: Finding Information ‎ (← links)
• How To contribute I: Wiki and References (redirect page) ‎ (← links)
  • How To Contribute I: Wiki and References (redirect page) ‎ (← links)
    • Best Practices (redirect page) ‎ (← links)
    • How To I: Wiki and References (redirect page) ‎ (← links)