Home

URL-Syntax


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.


General pages

  • /
    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.


Parameters for sorting

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?

    • values (can be linked with a | ):
      • author - the author's name
      • editor - the editor's name
      • year - year of publication
      • entrytype - type of publication
      • title - title
      • booktitle - the book's title (especially in collections)
      • journal - the journal's name
      • school - the university's name
  • sortPageOrder - order of sorting

    • values:
      • asc - ascending
      • desc - descending
  • duplicates

    • values:
      • yes - duplicates allowed
      • no - no duplicates in result list

Example:
?sortPage=year&sortPageOrder=asc&duplicates=no
Sort by year (sortPage=year) ascending (sortPageOrder=asc) and remove all duplicates (duplicates=no).


Administrative pages

  • /settings
    On this page you can:
    • add a user to your group,
    • find your API key and generate a new key,
    • import your del.icio.us data,
    • change your password,
    • change your account settings (email, name of your homepage),
    • synchronize your data between BibSonomy and PUMA.
  • /postPublication
    On this page you can:
    • enter type, title, author, publisher and year to post a publication,
    • insert a selected BibTeX snippet into a text box to post one or more BibTeX entries,
    • upload a BibTeX file to post one or more BibTeX entries.

Author pages

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 search: year of publication

A system tag can restrict your (author) search result to a specific year or range of years. Four formats are available:


Friends pages

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

    • add a friend to your friends list,
    • remove a friend from your friends list.
  • /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.


Groups

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 pages


Relations and Tags


Relations and concept pages


Search pages

  • /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.


Viewable pages

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.


Handling duplicates

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.


Export pages

  • /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.


RSS-Feeds


Reference metadata and formatting

  • /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.


HTML formatting


Semantic web formatting


URL or BibTeX pages


Content negotiation pages

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:

  • URL and BibTeX pages
  • author pages
  • BibTeX-Key pages

Examples:

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:

  • text/xml
  • image/png
  • text/html
  • text/plain
  • */*

Jabref layouts

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.