Advice: This page contains information intended for developers and technically experienced users.
This page contains all information about the PUMA URL syntax. You can click on all the links on this page to see an example of the outputs.
/
Home page of PUMA, shows the 50 recently posted public entries.
/popular
Shows the 100 most often posted entries of the last 100.000 public posts.
/help_en
The help homepage.
/help_en/FAQ
A page with the frequently asked questions (FAQ) and their answers.
/user/jaeschke
Shows all public posts of the user jaeschke.
/user/jaeschke/web
Shows all public posts with the tag web of the user jaeschke.
/user/jaeschke/web%20api
Shows all public posts with the tag web and the tag api of the user jaeschke.
/myHome
Link to the list of your own bookmarks and bibliographic references.
/myBibTeX
Link to the BibTeX list of all your own bibliographic references.
/myRelations
Link to the list of your own relations.
/myDocuments
Link to your own collection of full texts (PDF, PS, TXT, DJV or DJVU).
/myDuplicates
Link to your own duplicates.
When you see a page with publication/bookmark lists in PUMA, you are able to sort them by adding one or more of the following parameters behind the URL. Here's a list of existing parameters:
items - How many items should be displayed?
(For example: ?items=30 will show 30 items.)
Note: If you do not add the item-parameter with a certain number, a default number of maximum 20 items will be shown.
sortPage - How is the list sorted?
sortPageOrder - order of sorting
duplicates
Example:
?sortPage=year&sortPageOrder=asc&duplicates=no
Sort by year (sortPage=year) ascending (sortPageOrder=asc) and remove all duplicates (duplicates=no).
PUMA offers a way to retrieve publications by the names of their authors. There are several options to filter these search results. Currently, the filters include the year of publication, a special tag and the username of the person who stored the post.
/author/hotho
Shows all public posts with the author Hotho.
/author/stumme+hotho+schmitz
Shows all publications published by these authors.
/author/stumme+hotho+!schmitz or /author/stumme+hotho+%21schmitz
Specifies names of an author who should not be part of the searched publications, e. g. show all publications written by Stumme and Hotho, but not by Schmitz.
/author/hotho/clustering
Shows all posts with the tag 'clustering' and the author Hotho.
/author/stumme/sys:user:hotho
Shows all publications of the author 'Stumme' in the collection of the user 'hotho'.
/author/stumme+hotho+!schmitz/sys:year:2002-2007%20sys:user:hotho%20folksonomy This combination of search results returns all publications of the authors Stumme and Hotho but not Schmitz between the years 2002 and 2007 in user Hotho's collection marked with the tag 'folksonomy'.
/author/stumme/sys:group:kde Shows all publications of the author Stumme in the collections of all group members of the group 'kde'.
A system tag can restrict your (author) search result to a specific year or range of years. Four formats are available:
/author/stumme/sys:year:2007
Returns all publications of the author Stumme of the year 2007.
/author/stumme/sys:year:2003-2007
Returns all publications of the author Stumme between 2003 and 2007.
/author/stumme/sys:year:-2005
Returns all publications of the author Stumme until the year 2005.
/author/stumme/sys:year:1997-
Returns all publications of the author Stumme since 1997.
You get an introduction about visibility on the page friends. In the following section, the most important URLs about friends are listed.
/friends
Shows all posts which are set visible for friends of all users which declared you as their friend. Additionally you can
/friend/jaeschke
Shows all posts which are set visible for friends of the user jaeschke. You can only see them if jaeschke declared you a friend.
/friend/jaeschke/web
Shows all posts with the tag 'web' which are set visible for friends of the user jaeschke. You can only see them if jaeschke declared you a friend.
/friend/jaeschke/web%20api
Shows all posts with the tag 'web' and the tag 'api' which are set visible for friends of the user jaeschke. You can only see them if jaeschke declared you a friend.
You get an introduction about visibility on the page group functions. In the following section, the most important URLs about groups are listed.
/groups
Shows all groups of the system.
/group/kde
Shows all posts of members of the group 'kde', if you are a member of the group.
/group/kde/web
Shows all posts (which you are allowed to see) with the tag 'web' of members of the group 'kde', if you are a member of the group.
/group/kde/web%20api
Shows all posts with the tag 'web' and the tag 'api' of the members of the group 'kde', if you are a member of the group.
/relevantfor/group/kde
Shows all posts relevant for the members of the group.
/followers
Shows the recent posts of all users you are following and applies a ranking algorithm to show the most relevant ones for you on top of the list.
/tag/web
Shows all public posts with the tag 'web'.
/tag/web%20api
Shows all public posts with the tag 'web' and the tag 'api'.
/tag/web?order=folkrank
Shows all public posts with the tag 'web' and orders the results by the FolkRank algorithm.
/api/tags/data
Shows all related tags to 'data'.
/api/tags/data?relation=related
Shows all related tags to 'data'.
/api/tags/data?relation=similar
Shows all similar tags to 'data'.
/relations/schmitz
Shows all relations of the user schmitz.
/concept/user/schmitz/event
Shows all bookmarks and publications of the user schmitz which have 'event' or one of the relation's subtags as tags.
/search/web
Shows all public posts which contain the word 'web' (in the text and in the tags!). In case of a bookmark, the full text contains the URL, the title and the description. In case of a publication, the title, the description and all BibTeX fields are included.
/search/web%20api
Shows all public posts which contain the word 'web' and the word 'api' (in the text, not in the tags!). In case of a bookmark, the full text contains the URL, the title and the description. In case of a publication, the title, the description and all BibTeX fields are included.
/search/web%20-api
Shows all public posts which contain the word 'web' but not the word 'api' (in the text, not in the tags!). In case of a bookmark, the full text contains the URL, the title and the description. In case of a publication, the title, the description and all BibTeX fields are included.
/search/web%20user:jaeschke
Shows all public posts of the user jaeschke which contain the word 'web' (in the text, not in the tags!). In case of a bookmark, the full text contains the URL, the title and the description. In case of a publication, the title, the description and all BibTeX fields are included.
/search/web%20api%20user:jaeschke
Shows all public posts of the user jaeschke which contain the word 'web' and the word 'api' (in the text, not in the tags!). In case of a bookmark, the full text contains the URL, the title and the description. In case of a publication the title, the description and all BibTeX fields are included.
/search/web%20-api%20user:jaeschke
Shows all public posts of the user jaeschke which contain the word 'web' but not the word 'api' (in the text, not in the tags!). In case of a bookmark, the full text contains the URL, the title and the description. In case of a publication, the title, the description and all BibTeX fields are included.
/mySearch
This page offers a quick search in your collection.
For an overview on the different search options PUMA offers, check the search help page.
You get an introduction about visibility on the pages friends and group functions. In the following section, the most important URLs about visibility are listed.
/viewable/public
Shows all your posts which you set viewable for public.
/viewable/public/web
Shows all your posts with the tag 'web' which you set viewable for public.
/viewable/public/web%20api
Shows all your posts with the tag 'web' and the tag 'api' which you set viewable for public.
/viewable/private
Shows all your posts which you set viewable for private.
/viewable/private/web
Shows all your posts with the tag 'web' which you set viewable for private.
/viewable/private/web%20api
Shows all your posts with the tag 'web' and the tag 'api' which you set viewable for private.
/viewable/friends
Shows all your posts which you set viewable for friends.
/viewable/friends/web
Shows all your posts with the tag 'web' which you set viewable for friends.
/viewable/friends/web%20api
Shows all your posts with the tag 'web' and the tag 'api' which you set viewable for friends.
/viewable/kde
Shows all posts (if you are allowed to see them) which were set viewable for the group 'kde'.
/viewable/kde/web
Shows all posts (if you are allowed to see them) with the tag 'web' which were set viewable for the group 'kde'.
/viewable/kde/web%20api
Shows all posts (if you are allowed to see them) with the tag 'web' and the tag 'api' which were set viewable for the group 'kde'.
On several pages, entries (publications) are displayed which come from different users. As an example, if two or more users within a group have posted the same publication, this publication will appear twice on the corresponding group page.
If this is not desired, the handling of such duplicate entries can be controlled with the parameter duplicates:
/group/kde/myown
Shows all posts of all group members of the group 'kde' that are tagged with 'myown' (including duplicates).
/group/kde/myown?duplicates=no
Shows all posts of all group members of the group 'kde' that are tagged with 'myown', not including duplicates: For each set of identical publications, only the first publication is displayed.
/group/kde/myown?duplicates=merged
Shows all posts of all group members of the group 'kde' that are tagged with 'myown', with duplicates merged: For each set of identical publications, all tags are aggregated into a single post, which is displayed.
/clipboard
Here you can manage publication posts you picked with the "pick" button.
/export/
Shows a variety of formats which you can select to export publication metadata.
The following URLs are shortcuts which can also be clicked on the export page.
/bib/
BibTeX format of all publications of the main publication page.
/bib/user/beate
BibTeX format of all publications of the publication page of the user beate.
/endnote/
EndNote format of the publications of the main page.
/publ/
A simple layout where entries are shown as a list in a table.
/publ/?notags=1
Suppresses the PUMA tags in the HTML output.
/publ/user/beate
A publication list of the user beate.
/publ/user/beate/myown
A publication list of the user beate with the tag myown.
/url/d1bb7b3f6cafafa7b418f9f356ff2e83
Shows all public bookmark posts of the URL with the MD5 hash d1bb7b3f6cafafa7b418f9f356ff2e83.
/url/d1bb7b3f6cafafa7b418f9f356ff2e83/jaeschke
Shows the bookmark posts (if you are allowed to see it) of the user jaeschke with the MD5 hash d1bb7b3f6cafafa7b418f9f356ff2e83.
/bibtex/1d28c9f535d0f24eadb9d342168836199
Shows all public publication posts with the hashkey 1d28c9f535d0f24eadb9d342168836199. The used hash is the Inter-Hash.
/bibtex/25854a71547051543dd3d3d5e2e2f2b67/steff83
Shows the publication post (if you are allowed to see it) of the user steff83 with the hashkey 25854a71547051543dd3d3d5e2e2f2b67. The used hash is the Intra-Hash. PUMA provides a Tag JSON Feed belonging to a BibTeX post.
/json/tags/bibtex/1d28c9f535d0f24eadb9d342168836199
Provides A JSON output containing all tags related to the publication with the Inter-Hash 1d28c9f535d0f24eadb9d342168836199. PUMA offers the possibility to retrieve a publication by its BibTeX key.
/bibtexkey/Wille82
Returns publications which have the BibTeX key Wille82.
/bibtexkey/wille82+sys:user:Stumme
Returns publications which have the BibTeX key Wille82 from the collection of the user Stumme.
/bibtexkey/hjss06bibsonomy+sys%3Auser%3Ajaeschke
Shows all posts (which you are allowed to see) with the specified BibTeX key hjss06bibsonomy
of the user jaeschke. If you have more than one entry with the same BibTeX key, then a list of all hits will be given.
/bibtexkey/journals/jacm/HopcroftU69/dblp
You can use BibTeX semantics to refer to entries that we mirror from DBLP, once you know how DBLP generates its BibTeX keys.
Content negotiation helps to show a source with the same URL in different ways, according to the settings of the user agent. Adding the keyword uri
to your URL enables content negotiation. This is available for the following pages:
Examples:
/uri/url/d1bb7b3f6cafafa7b418f9f356ff2e83
Shows all bookmarks with the specified hash.
/uri/bibtex/2b8b87c78e9e27a44aacde0402c642bff
Shows all BibTeX entries with the specified hash.
/uri/bibtexkey/hjss06bibsonomy/jaeschke
Shows all BibTeX entries with the specified key of the user jaeschke.
/uri/author/hotho
Shows all BibTeX entries of the author hotho.
The current supported output formats are HTML, XML, RSS, RDF, and BibTeX. The user agent specifies a preferred output format in the HTML accept header defining the priority order with the help of q-values.
For example, the header definition
Accept:text/xml;q=1,text/html;q=0.9,text/plain;q=0.8,image/png;q=1,*/*;q=0.5
would trigger the following priority:
The export page gives an overview on all available Jabref layouts.
/layout/simplehtml/
HTML layout without any header or footer. Useful for integrating publication lists into other HTML pages.
/layout/html/
A simple layout where entries are shown as a list in a table.
/layout/tablerefs/
HTML output with each entry shown as a list in a table and an additional JavaScript search function.
/layout/tablerefsabsbib/
Similar to TableRefs. Also includes the BibTeX source and the abstract of the publication.
/layout/docbook/
This is an XML output according to the DocBook schema.
/layout/endnote/
Output in RIS format which is used by EndNote, a bibliography management tool.
/layout/dblp/
DBLP exports your records to a DBLP conformable XML structure.
/layout/text/
BibTeX output.
Click here to go back to beginner's area and learn more about the basic functions.