Difference between revisions of "App/ref"

From mx Help Wiki
Jump to: navigation, search
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
We now support a fairly broad range of fields for references such that users should be able to maintain a personal reference list in mx.  Reference records are shared across projects as well.  This becomes very handy when others have entered sets of references that are largely congruent with yours.  Functionality also exists to merge synonymous references while maintaining referential integrity.
+
<div style="float: right; margin: 0em 1em 1em 1em; padding: 0em 1em 1em 1em;">__TOC__</div>
  
−
== Rendering the reference ==
+
== Overview ==
  
 +
Mx now supports a fairly broad range of fields for references such that users should be able to maintain a personal reference list in mx.  Reference records are shared across projects as well.  This becomes very handy when others have entered sets of references that are largely congruent with yours.  Functionality also exists to merge synonymous references while maintaining referential integrity.
  
−
=== On Authors ===
+
== Searching ==
 +
[[Image:litSearch.png]]
  
−
An author will be rendered (by mx) something like this: ‘Yoder, M. J.’. The data for this rendering can look like this:
 
  
−
{|
+
Here is the big list of references already in the database. Start typing into the search box to see if your reference is in there yet. You can start typing anything - from 'last name', 'year', 'title', etc. - and it will be searched.
−
|-
+
−
! last name || first name || initials
+
−
|-
+
−
|Yoder || Matthew || J ||
+
−
|-
+
−
|Yoder || MJ || || bad, but will render ok
+
−
|-
+
−
|Yoder || M || J ||
+
−
|-
+
−
|Yoder || Matthew Jon || || also bad (middle name should be initial), but will render ok, and the format to use for multiple given first names
+
−
|}
+
  
 +
== Adding new References ==
 +
Information about how to add new references and definitions of fields are found in [[App/ref/new]]
  
 +
== Merging duplicate references ==
 +
Information about how to merge duplicate references is found in [[App/ref/show]]
  
−
 
+
== Sharing References ==
−
 
+
−
<p style="color:red;">
+
−
This type of data should be avoided, and in the future will not be allowed:
+
−
 
+
−
{|
+
−
|-
+
−
! last name || first name || initials
+
−
|-
+
−
|Yoder, M. || || ||
+
−
|-
+
−
|Yoder || M.J. || ||
+
−
|-
+
−
|Yoder || Matthew J. || ||
+
−
|-
+
−
|Yoder || Matthew || J.  ||
+
−
|-
+
−
|Yoder || Matthew Jon || M. J.  ||
+
−
|}
+
−
</p>
+
−
 
+
−
Authors are added to references according to 1) their order of addition, which is overwritten by 2) their position number if given. To add multiple authors to a reference first create the reference with a single (the first) author. After creating the record edit it and you will be presented with another blank set of author fields. Enter the next author and click update…repeat.
+
−
 
+
−
Available Fields
+
−
year the year
+
−
year_letter if you want to keep manual track of the year letter you can use this field, enter only the letter, not the year
+
−
ref_type chosen from a dropdown, if in doubt choose Journal Article
+
−
title No punctuation or capitalization beyond the first word
+
−
volume no punctuation
+
−
issue or number, no punctuation
+
−
pg_start a number, no punctuation
+
−
pg_end a number, no punctuation
+
−
pages used only if starting page is empty, otherwise ignored, for things like 72a-194ii
+
−
Book specific fields
+
−
date of publication
+
−
book_title the book title
+
−
city city of publication
+
−
publisher publisher
+
−
institution publishing institution
+
−
temp_citation if you want you may use this as a temporary marker, it is displayed only at last resort
+
−
full_citation use ONLY if primary fields not filled, will be displayed if no author or year or title is given
+
−
Conference Proceedings
+
−
 
+
−
The title of the talk goes in the title field, and the name of the conference goes under book title.
+
−
Serials
+
−
 
+
−
A list of serials is shared among all projects. Serials are tied to references by the blue drop down.
+
−
Navigating
+
−
 
+
−
When you update/edit a reference you can use the ‘update and next’ to commit the changes and automatically move to the next record.
+
−
 
+
−
== Merging and sharing references ==
+
−
 
+
−
=== Merging duplicate references ===
+
−
 
+
−
We have added the ability to merge duplicate references. Click 'show', then 'replace with another reference'. All tags, OTUs, etc. that were linked to the duplicate reference will be linked to the replacement.
+
−
 
+
−
=== Sharing References ===
+
  
 
All references entered into mx are available to any project; you just have to add them to your list (click 'add refs from another project').  
 
All references entered into mx are available to any project; you just have to add them to your list (click 'add refs from another project').  
Line 87: Line 24:
  
 
You will get an email notification describing the changes.
 
You will get an email notification describing the changes.
 +
 +
== Problems with PDF upload ==
 +
 +
Firefox has known problems with mimetypes.  See the [[FAQ]] for how to reset your browser so that it properly recognizes pdfs.

Latest revision as of 11:50, 8 February 2011

[edit] Overview

Mx now supports a fairly broad range of fields for references such that users should be able to maintain a personal reference list in mx. Reference records are shared across projects as well. This becomes very handy when others have entered sets of references that are largely congruent with yours. Functionality also exists to merge synonymous references while maintaining referential integrity.

[edit] Searching

Error creating thumbnail: Unable to save thumbnail to destination


Here is the big list of references already in the database. Start typing into the search box to see if your reference is in there yet. You can start typing anything - from 'last name', 'year', 'title', etc. - and it will be searched.

[edit] Adding new References

Information about how to add new references and definitions of fields are found in App/ref/new

[edit] Merging duplicate references

Information about how to merge duplicate references is found in App/ref/show

[edit] Sharing References

All references entered into mx are available to any project; you just have to add them to your list (click 'add refs from another project').

[edit] What happens when someone in another project edits one of my references?

You will get an email notification describing the changes.

[edit] Problems with PDF upload

Firefox has known problems with mimetypes. See the FAQ for how to reset your browser so that it properly recognizes pdfs.

Retrieved from "http://mx.phenomix.org/index.php?title=App/ref&oldid=3843"
Personal tools