![]() |
CiteULike | ![]() |
![]() |
|
![]() |
Register | ![]() |
Log in | ![]() |
This is a collection of HOWTOs and FAQs contributed by CiteULike Users
If you would like to contribute, please send an email to howtos(at)citeulike.org. We reserve the right to edit contributions.
If there's any topic you'd like answered here, you can also try posting in the discussion forums.
If you want to create a link to one of these items, use a URL like:
http://www.citeulike.org/howto?show=sec1-2


You do this by giving all your articles a common tag.

Currently, this is not possible.
Select the tag to want to delete by either,
Select the link at the top of the page "Delete all <tagname> articles"
Update: our advanced bookmarket solves this problem.
The URL I am trying to post is http://www.ncbi.nlm.nih.gov/sites/entrez
This is a known problem, and one which is proving to be quite a pain. It all stems from the way PubMed deals with the case when there's precisely one result for the search term you type in. Normally you'd type in your phrase, get a list of possible results, and then click one to get the the article summary page. Under those conditions, you'll notice that you get a page with a URL which contains enough information to work out which article you're looking at. On the other hand, when there's only one result which matches your search term, you'll find that the URL doesn't give you this information. In other words, it's not possible to bookmark that page. Consequently, CiteULike gets quite confused and can't work out which article to bookmark. It's something we're going to fix, but it requires quite a radical re-think of how the bookmarklet works.
In the meantime the (ugly) workaround is:
You're quite welcome to post anything you like, including arbitrary web sites (but read the restriction below about non peer-reviewed articles not being as prominently displayed). You could, if you wanted, use CiteULike to keep track of your browser's bookmarks. It is, however, a tool specifically designed to work with academic papers, so if you just want just use it as a bookmark manager, you might be better off using another service like del.icio.us. We do not allow CiteULike to be used for SPAM - we will delete SPAM where we find it.
You may also want to try out our experimental "advanced" bookmarklet, available on this page.
You can now put /postdate/... in URLs for your own library. At present, /postdate/... won't work if you also specify /tag or /aurthor in the URL (it does work for e.g. BibTeX exports).
You can specify an optional start date and an optional end date, separated with a '-'. A date can be of the form YYYY, YYYYMM or YYYYMMDD. If the MMDD or DD parts are missing they are expanded to 0101 or 01 respectively if the date is the left hand side of the '-', and to 1231 or 31 respectively if the date is the right side of the '-'. If there's just one date and no '-' it's taken as the left and right side, and expanded as above.
http://www.citeulike.org/user/.../postdate/2007-2008 expands to date range 2007-01-01 to 2008-12-31
http://www.citeulike.org/user/.../postdate/200707-200708 expands to date range 2007-07-01 to 2007-08-31
http://www.citeulike.org/user/.../postdate/20070801-20070812 is date range 2007-08-01 to 2007-08-12
http://www.citeulike.org/user/.../postdate/2007 expands to date range 2007-01-01 to 2007-12-31
http://www.citeulike.org/user/.../postdate/2007- expands to date range 2007-01-01 onwards
http://www.citeulike.org/user/.../postdate/-200807 expands to date range 2008-07-31 and before
You can access database entries that are marked with two (or more) specific tags (e.g. 'tag1' and 'tag2') by appending to the URL '/tag/tag1,tag2'.
For example, to select all articles in my library tagged 'ferromagnet', 'nanotube', and 'kondo', use
http://www.citeulike.org/user/akhuettel/tag/ferromagnet,nanotube,kondo
Excluding a tag can be done by prepending it with '!'. So, all articles with 'ferromagnet' and 'kondo', but WITHOUT 'nanotube', are given by
http://www.citeulike.org/user/akhuettel/tag/ferromagnet,!nanotube,kondo
The same functionality also exists for user names ('/user/...') and author names ('/author/...'). So, all articles in my ('akhuettel') library with author 'Kouwenhoven' and tag 'nanotube' are found by
http://www.citeulike.org/user/akhuettel/tag/nanotube/author/Kouwenhoven
The above examples are reproduced by the queries
+tag:(ferromagnet AND nanotube AND kondo) +tag:(ferromagnet AND !nanotube AND kondo)
Information for the technically-minded: The CiteUlike search engine is driven by Apache Lucene. The full query parser syntax is documented at http://lucene.apache.org/java/2_4_1/queryparsersyntax.html
It's possible to sort any library or (e.g. tag-defined) sub-library by one of a limited number of fields. This feature works by appending a '/order/' string to the page URL. Its complete description can be found at the discussion forum http://www.citeulike.org/groupforum/767
A usage example would be to sort the articles in my library tagged 'ferromagnet' by reading priority:
http://www.citeulike.org/user/akhuettel/tag/ferromagnet/order/to_read
When you click on the title, you will get sent to the copy of that article owned by the user show below ("Posted by ...."). If you have a copy in your own library, the [My Copy] link will take you there instead.
The [My Copy] link is there even if it's your copy in the first place, otherwise it might be confusing.
Similarly, as PDF icon will take you to your own copy of a PDF, unless you're viewing a [private] group's page and the group has a PDF.
You can search your own notes through your library search form (i.e., not the global one at the top right). We hope to make non-private notes globally searchable soon.
If CiteULike incorrectly parses an author, you can force author name parts to be treated as 'first name', 'initials', 'last name' can be done by editing the name and setting it to be
=/<firstname>/<initials>/<lastnames>/=
Initials should include all the initials, including that of firstname.
e.g.,
=/Gerald/ZG/Liu/= =/John/JJ/van der Wahls/=
Note that the in latter case we can't distinguish between "John J van der Wahls" and "J John van der Wahls" and the former will be used.
For the special case of institutional "authors", you can use either of the following:
=///The Science Consortium/= "The Science Consortium"
Very occasionally, the metadata in an article is wrong, but you don't know a correct value. For example the issue number might appear as "-1" but there is no actual issue number for the article - so you can't put in an alternative value. Simply blanking out the value doesn't work because this means that you don't want to provide a replacement value and CiteULike will default back to the value it got from the original article, namely "-".
The solution is to put "//" in the field. This is a special marker to tell CiteULike that you want to override the default value with a empty one.
In the dropdown for "month", the equivalent is the "none" item.
All articles need a title, so you can't blank that.
No, your PDFs aren't viewable by others. Within a private group, they are viewable by others if you indicate that you have the right to distribute the PDF (e.g., you are the Copyright holder).
The PDF is stored on a CiteULike server and backed up every day.
Only one PDF per citation at the moment.
Maximum size is currently 20MB.
Nothing's wrong. If you posted a paper from a site that's not on the "supported" list, then it will appear in your library, but it won't be widely publicised on CiteULike (so it won't appear on the front page, and it won't appear in the "all papers for tag..." links). Of course, if you post a paper from one of our recognised journals, we know that the paper has already been peer-reviewed, and it will go on the front page.
This is hopefully an effective measure against both spam, and lunatics trying to peddle their crazy ideas about the origins of the universe.
The spam issue is obvious. If spammers worked out how to post links to the sites they're trying to advertise (and spammers are sometimes quite clever, if a little evil) and clutter up CiteULike with this junk then they'd obviously do it, and this site would be a worse place for it. Also, because we allow search engines onto CiteULike, the spammers might think that having lots of links to their site might boost their rankings in the Google search results. Actually, that wouldn't work because of a feature on Google... but they might not know that and try it anyway.
The "lunatics" problem is a bit more subtle. We regularly get emails from people who have posted articles (which clearly haven't been peer-reviewed) wanting to know what they can do to promote their work on CiteULike. The short answer is: nothing. These papers are generally either fairly curious ideas about the Big Bang, or results of less-than-scrupulous clinical trials of a drug (which is presumably manufactured by a company the user has shares in). CiteULike is not a place to try to push your own work to a larger audience (although, of course, you're welcome to submit your own articles and, if they're any good, others will bookmark them). This policy has the unfortunate side effect that some genuinely good articles might not be as visible as they might be. Hopefully this should slowly become less of an issue as as the number of supported journals increases.
Mostly it's a compromise. The PDF previewer isn't really that good - to read the paper properly we recommend using a proper PDF reader, such as Acrobat. Since some PDFs are very large (and therefore possibly slow to download) we felt it was reasonable to just show the the first pages to give you a flavour. The reason it's the first 2 pages rather than just the first is that quite often papers have a "cover page".
Also, the viewer isn't reading the PDF but the PDF converted into Flash, which puts extra demands on our resources.
Some PDFs are copy-protected and our software won't read them. Some others have errors that our software can't deal with, despite being readable in Acrobat.
At the time of writing approx. 1% of PDFs have no preview.
We don't delete old accounts. You can
At that point, all we have is a username and an email address.
If you want, you can change your email to a non-existant one, but note that once you have done that, you may no longer be able to prove that you own the account. We suggest you only do this as the very last step, once you are happy that all other data has been your library.
Please also see our Privacy Statement and Terms & Conditions
It is not possible to do it yourself, but in you can ask CiteULike admins to do this.
[thegoose says: Please only ask if you really need to as it's quite a bit of work.]
Post your request in the general citeulike forum.
[thegoose says: With enough nagging we might get around to implementing this one day. In theory one could export the library from one and import into another but the imported library won't be able to make use of social features (we're working on this one, though).]
Our privacy policy is available here.
Long Method:
If you have forgotten your current password, things are a bit more complicated. We'll send you an email with a link to reset your password.
See here
You can export the current view to Delicious whenever you see the button.
Save the file, and import into Delicious ("Setting" -> "Bookmarks" -> "Import..."). In general, we recommend importing into Delicious as "public" - any private articles will still be private.
Because of privacy and size restrictions we've had to make a few compromises:
Yes. Probably the most useful thing you could do at the moment is write a "plugin" to let CiteULike work with a currently unsupported publisher's site. Do you post articles from a site which the system doesn't know how to extract the details from (you have to type them in yourself)? Do you know a little programming? If so, you might like to check out the plugin subversion repository and the documentation. If you've got subversion installed, you can check out the source code to your local drive by
svn co http://svn.citeulike.org/svn/ citeulike
We see all the public data as being a valuable academic resource for people who work in text mining. If anyone is interested in the dataset for a sensible (non-commercial) purpose then it is available for download here.
For German-speaking users, there is a wiki-based tutorial available here [http://moodle.donau-uni.ac.at]. It was created by a postgraduate student at Donau-Universität Krems.
We have forums for general discussion, feature requests and bug reports available here; there's a summary of recent activity here.
Simply add the following javascript to your page:
CiteULike is hosted in a professional datacentre and the database is backed up every night.
Without a popup:
http://www.citeulike.org/posturl?url=<url>&title<title>
where <url> and <title> are the (URL-encoded) URL and Title of the article. Typically this code will do:
<a href="javascript:location.href='http://www.citeulike.org/posturl?url='+encodeURIComponent(location.href)+'&title='+encodeURIComponent(document.title)">Post to CiteULike</a>
However, in certain circumstances a different URL or title may be appropriate. One can also post the DOI directly using the a 'URL' like "doi:10.1234/12345667" though this is slightly slower because of the extra lookup via doi.org.
With a popup:
We recommend the following (the javascript part all in one line - no spaces)
<a href="javascript:var%20pw=window.open('http://www.citeulike.org/posturl?bml=popup
&url='+encodeURIComponent(location.href)+'&title='+encodeURIComponent(document.title),
'citeulike_popup_post','width=1000,height=700,scrollbars=1,resizable=1');
void(window.setTimeout('pw.focus()',250));">Post to CiteULike</a>
You may change the popup size, but it's important to use the window name 'citeulike_popup_post' as we use this to trigger certain options suitable for popups.
Icon: This one is suitable
or contact us for advice on other options.