Hinweis: Diese Seite richtet sich ausschließlich an Entwickler und technisch versierte Nutzer.

URL-Syntax#

Diese Seite fasst alle Informationen zur PUMA-URL-Syntax zusammen. Alle Links auf dieser Seite können angeklickt werden um eine Beispielausgabe anzuzeigen (insbesondere hilfreich bei Such-URLs).



Allgemeine Seiten#

  • /
    Homepage von PUMA, zeigt die aktuellsten 50 öffentlichen Einträge.

  • /popular
    Zeigt die 100 häufigsten Einträge der letzten 100.000 öffentlichen Einträge.

  • /help_de
    Die Hilfeseite.

  • /help_de/FAQ
    Eine Seite, die die am häufigsten gestellten Fragen und ihre Antworten enthält.

  • /user/jaeschke
    Zeigt alle öffentlichen Einträge des Benutzers jaeschke.

  • /user/jaeschke/web
    Zeigt alle öffentlichen Einträge mit dem Schlagwort (Tag) web des Benutzers jaeschke.

  • /user/jaeschke/web%20api
    Zeigt alle öffentlichen Einträge mit dem Tag web und dem Tag api des Benutzers jaeschke.

  • /myHome
    Link zu der Liste Ihrer eigenen Lesezeichen und bibliografischen Referenzen.

  • /myBibTeX
    Link zur BibTeX-Liste Ihrer eigenen bibliografischen Referenzen.

  • /myRelations
    Link zur Liste Ihrer eigenen Relationen.

  • /myPDF
    Link zu Ihrer Sammlung von Volltexten (PDF, PS, TXT, DJV or DJVU).

  • /myDuplicates
    Link zu Ihren eigenen Duplikaten.

Parameter zum Sortieren#

Immer wenn Sie in PUMA Zugriff auf eine Lesezeichen/Publikationsliste haben, können Sie diese sortieren, indem Sie an die URL einen/mehrere der folgenden Parameter anhängen. Folgende Parameter stehen Ihnen zur Verfügung:

  • sortPage - Wonach wird sortiert?
    • Werte (können durch | verknüpft werden):
      • author - Autorenname
      • editor - Herausgebername
      • year - Erscheinungsjahr
      • entrytype - Publikationstyp
      • title - Titel
      • booktitle - Buchtitel (insb. bei Artikel in Sammelbänden)
      • journal - Journalname
      • school - Universitätsname
  • sortPageOrder - Reihenfolge der Sortierung
    • Werte:
      • asc - aufsteigend
      • desc - absteigend
  • duplicates
    • Werte:
      • yes - Erlaube Duplikate
      • no - Entferne Duplikate aus der Ergebnisansicht

Beispiel:
?sortPage=year&sortPageOrder=asc&duplicates=no
Sortiere nach Erscheinungsjahr (sortPage=year) aufsteigend (sortPageOrder=asc) und entferne alle Duplikate (duplicates=no)

Verwaltungsseiten#

  • /settings
    Auf dieser Seite können Sie:
    • einen Benutzer zu Ihrer Gruppe hinzufügen,
    • Ihren API-Schlüssel finden und einen neuen erzeugen,
    • Ihre del.icio.us-Daten importieren,
    • Ihr Passwort ändern,
    • Ihre Kontoeinstellungen ändern (E-Mail, Name der Homepage),
    • Ihre Daten zwischen BibSonomy und PUMA synchronisieren.

  • /postBookmark
    Auf dieser Seite können Sie:
    • eine URL eingeben, um einen Lesezeicheneintrag zu generieren.

  • /postPublication
    Auf dieser Seite können Sie:
    • Typ, Titel, Autor, Herausgeber und Jahr eingeben, um einen Publikationseintrag zu generieren,
    • einen ausgewählten BibTex-Schnipsel in eine Textbox einfügen, um einen oder mehrere BibTex-Einträge zu generieren,
    • eine BibTex-Datei hochladen, um einen oder mehrere BibTex-Einträge zu generieren.

Autorenseiten#

PUMA bietet eine Möglichkeit, Publikationen über die Namen ihrer Autoren zu finden. Es gibt verschiedene Wege, diese Suchergebnisse zu filtern. Gegenwärtig beinhalten die Filter das Publikationsjahr, einen besonderen Tag und den Benutzernamen der Person, die den Eintrag gespeichert hat.

Autorensuche: Erscheinungsjahr#

Ein Systemtag (System-Schlagwort) kann das Ergebnis Ihrer Autorensuche auf ein bestimmtes Erscheinungsjahr oder einen bestimmten Zeitraum beschränken. Es sind vier Formate möglich:

Freundeseiten#

Eine Einführung in die Sichtbarkeitseinstellungen finden Sie unter Freunde. Im folgenden Abschnitt werden die wichtigsten Freunde-URLs aufgeführt.

  • /friends
    Zeigt alle für Freunde sichtbar gesetzten Einträge aller Benutzer, die Sie als Ihren Freund angegeben haben. Zusätzlich können Sie:
    • einen Freund zu Ihrer Freundesliste hinzufügen,
    • einen Freund von Ihrer Freundesliste entfernen.

  • /friend/jaeschke
    Zeigt alle Beiträge, welche für Freunde des Benutzers jaeschke sichtbar gesetzt sind. Sie können sie nur dann sehen, wenn jaeschke Sie als Freund angegeben hat.

  • /friend/jaeschke/web
    Zeigt alle Beiträge mit dem Tag 'web', welche für Freunde des Benutzers jaeschke sichtbar gesetzt sind. Sie können sie nur dann sehen, wenn jaeschke Sie als Freund angegeben hat.

  • /friend/jaeschke/web%20api
    Zeigt alle Beiträge mit dem Tag 'web' und dem Tag 'api', welche für Freunde des Benutzers jaeschke sichtbar gesetzt sind. Sie können sie nur dann sehen, wenn jaeschke Sie als Freund angegeben hat.

Gruppenseiten#

Eine Einführung in die Sichtbarkeitseinstellungen finden Sie unter Gruppen. Im folgenden Abschnitt werden die wichtigsten Gruppen-URLs aufgeführt.

  • /groups
    Zeigt alle Gruppen des Systems an.

  • /group/kde
    Zeigt alle Einträge von Mitgliedern der Gruppe 'kde', wenn Sie Gruppenmitglied sind.

  • /group/kde/web
    Zeigt alle Einträge mit dem Tag 'web' von Mitgliedern der Gruppe 'kde', wenn Sie Gruppenmitglied sind.

  • /group/kde/web%20api
    Zeigt alle Einträge mit dem Tag 'web' und dem Tag 'api' von Mitgliedern der Gruppe 'kde', wenn Sie Gruppenmitglied sind.

  • /relevantfor/group/kde
    Zeigt alle Einträge, die für die Teilnehmer der Gruppe relevant sind.

  • /followers
    Zeigt die neuesten Einträge aller Benutzer, denen Sie folgen. Diese Einträge werden mittels eines Rankings so umsortiert, dass die für Sie relevantesten Einträge ganz oben stehen.

Tagseiten/Schlagwortseiten#

Relationen und Tags#

Relationen und Begriffsseiten#

  • /relations/schmitz
    Zeigt alle Relationen des Benutzers schmitz.

  • /concept/user/schmitz/event
    Zeigt alle Lesezeichen und Publikationen des Benutzers schmitz, denen das Schlagwort (Tag) 'event' oder eines der Unterschlagwörter der Relation als Tag zugeordnet ist.

Suchseiten#

  • /search/web
    Zeigt alle öffentlichen Einträge, die im Volltext (nicht in den Schlagwörtern!) das Wort 'web' enthalten. Bei Lesezeichen enthält der Volltext die URL, den Titel und die Beschreibung. Bei Publikationen sind der Titel, die Beschreibung und alle BibTex-Felder enthalten.

  • /search/web%20api
    Zeigt alle öffentlichen Einträge, die im Volltext (nicht in den Schlagwörtern!) das Wort 'web' und das Wort 'api' enthalten. Bei Lesezeichen enthält der Volltext die URL, den Titel und die Beschreibung. Bei Publikationen sind der Titel, die Beschreibung und alle BibTex-Felder enthalten.

  • /search/web%20-api
    Zeigt alle öffentlichen Einträge, die im Volltext (nicht in den Schlagwörtern!) das Wort 'web', aber nicht das Wort 'api' enthalten. Bei Lesezeichen enthält der Volltext die URL, den Titel und die Beschreibung. Bei Publikationen sind der Titel, die Beschreibung und alle BibTex-Felder enthalten.

  • /search/web%20user:jaeschke
    Zeigt alle öffentlichen Einträge des Benutzers jaeschke, die im Volltext (nicht in den Schlagwörtern!) das Wort 'web' enthalten. Bei Lesezeichen enthält der Volltext die URL, den Titel und die Beschreibung. Bei Publikationen sind der Titel, die Beschreibung und alle BibTex-Felder enthalten.

  • /search/web%20api%20user:jaeschke
    Zeigt alle öffentlichen Einträge des Benutzers jaeschke, die im Volltext (nicht in den Schlagwörtern!) das Wort 'web' und das Wort 'api' enthalten. Bei Lesezeichen enthält der Volltext die URL, den Titel und die Beschreibung. Bei Publikationen sind der Titel, die Beschreibung und alle BibTex-Felder enthalten.

  • /search/web%20-api%20user:jaeschke
    Zeigt alle öffentlichen Einträge des Benutzers jaeschke, die im Volltext (nicht in den Schlagwörtern!) das Wort 'web', aber nicht das Wort 'api' enthalten. Bei Lesezeichen enthält der Volltext die URL, den Titel und die Beschreibung. Bei Publikationen sind der Titel, die Beschreibung und alle BibTex-Felder enthalten.

  • /mySearch
    Diese Seite bietet eine Schnellsuche in Ihrer Sammlung.

Sichtbare Seiten#

Eine Einführung in die Sichtbarkeitseinstellungen finden Sie unter Gruppen sowie unter Freunde. Im folgenden Abschnitt werden die wichtigsten Sichtbarkeits-URLs aufgeführt.

  • /viewable/public
    Zeigt alle Ihre Einträge, die Sie als öffentlich sichtbar eingestellt haben.

  • /viewable/public/web
    Zeigt alle Ihre Einträge mit dem Tag (Schlagwort) 'web', die Sie als öffentlich sichtbar eingestellt haben.

  • /viewable/public/web%20api
    Zeigt alle Ihre Einträge mit dem Tag 'web' und dem Tag 'api', die Sie als öffentlich sichtbar eingestellt haben.

  • /viewable/private
    Zeigt alle Ihre Einträge, die Sie als privat sichtbar eingestellt haben.

  • /viewable/private/web
    Zeigt alle Ihre Einträge mit dem Tag 'web', die Sie als privat sichtbar eingestellt haben.

  • /viewable/private/web%20api
    Zeigt alle Ihre Einträge mit dem Tag 'web' und dem Tag 'api', die Sie als privat sichtbar eingestellt haben.

  • /viewable/friends
    Zeigt alle Ihre Einträge, die Sie als für Freunde sichtbar eingestellt haben.

  • /viewable/friends/web
    Zeigt alle Ihre Einträge mit dem Tag 'web', die Sie als für Freunde sichtbar eingestellt haben.

  • /viewable/friends/web%20api
    Zeigt alle Ihre Einträge mit dem Tag 'web' und dem Tag 'api', die Sie als für Freunde sichtbar eingestellt haben.

  • /viewable/kde
    Zeigt alle Einträge, die für die Gruppe 'kde' als sichtbar eingestellt wurden.

  • /viewable/kde/web
    Zeigt alle Einträge mit dem Tag 'web', die für die Gruppe 'kde' als sichtbar eingestellt wurden.

  • /viewable/kde/web%20api
    Zeigt alle Einträge mit dem Tag 'web' und dem Tag 'api', die für die Gruppe 'kde' als sichtbar eingestellt wurden.

Behandlung von Duplikaten#

Auf mehreren Seiten werden Einträge (Publikationen) angezeigt, die von mehreren Benutzern stammen. Ein Beispiel hierfür sind Gruppenseiten. Wenn innerhalb einer Gruppe zwei oder mehr Benutzer denselben Eintrag in Ihrer Sammlung haben, wird dieser ebenfalls mehrfach angezeigt.

Falls dies nicht gewünscht ist, kann das Verhalten mittels des Parameters duplicates wie folgt angepasst werden:

  • /group/kde/myown
    Zeigt alle Einträge der Gruppe 'kde' an, die mit dem Tag 'myown' annotiert sind (auch Duplikate).

  • /group/kde/myown?duplicates=no
    Zeigt alle Einträge der Gruppe 'kde' an, die mit dem Tag 'myown' annotiert sind; für jedes Duplikat wird nur der erste Eintrag angezeigt.

  • /group/kde/myown?duplicates=merged
    Zeigt alle Einträge der Gruppe 'kde' an, die mit dem Tag 'myown' annotiert sind; für jedes Duplikat werden alle Tags "aufgesammelt" und aggregiert an einem einzelnen Eintrag angezeigt.

Export von Seiten#

  • /clipboard
    Hier können Sie Publikationseinträge mit der Schaltfläche "Auswahl" verwalten.

  • /export/
    Zeigt eine Auswahl von Formaten an, die Sie zum Export von Publikationsmetadaten wählen können.

Die folgenden URLs sind Befehle, die auch auf der Export-Seite angeklickt werden können.

RSS Feeds#

Referenz-Metadaten und Formatierung#

  • /bib/
    BibTeX-Format aller Publikationen der Publikationshauptseite.

  • /bib/user/beate
    BibTeX-Format aller Publikationen der Publikationsseite des Benutzers beate.

  • /endnote/
    EndNote-Format der Publikationen der Hauptseite.

HTML-Formatierung#

  • /publ/
    Eine einfache Übersicht, in der jeder Eintrag als Zeile in einer Tabelle dargestellt ist.

  • /publ/?notags=1
    Unterdrückt die PUMA-Schlagwörter in der HTML-Ausgabe.

  • /publ/user/beate
    Die Publikationen des Nutzers beate.

  • /publ/user/beate/myown
    Die Publikationen des Nutzers beate mit dem Tag myown.

Semantic Web-Formatierung#

URL- oder BibTeX-Seiten#

Inhaltsvereinbarungsseiten#

Inhaltsvereinbarung (Content Negotiation) hilft dabei, eine Quelle mit derselben URL auf verschiedene Arten anzuzeigen, unter Berücksichtigung der Einstellungen des abfragenden Benutzers. Das Hinzufügen des Schlüsselworts uri zu Ihrer URL ermöglicht Ihnen die Inhaltsvereinbarung. Das Verfahren wird für die folgenden Seiten unterstützt:

  • URL- und BibTeX-Seiten
  • Autoren-Seiten
  • BibTeX-Schlüssel-Seiten

Beispiele:

Die gegenwärtig unterstützten Ausgabeformate sind HTML, XML, RSS, RDF und BibTeX. Der User Agent legt im HTML Accept Header ein bevorzugtes Ausgabeformat fest, im dem die bevorzugte Reihenfolge mit Hilfe von q-values definiert ist.
Beispielsweise bedeutet die Header-Definition

Accept:text/xml;q=1,text/html;q=0.9,text/plain;q=0.8,image/png;q=1,*/*;q=0.5

die folgende Reihenfolge:

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

Jabref-Layouts#

Einen kompletten Überblick zu allen verfügbaren Jabref-Layouts erhalten Sie auf der Export-Seite von PUMA.

  • /layout/simplehtml/
    HTML-Übersicht ohne Kopf- oder Fußzeile nützlich für die Einbindung von Publikationslisten in andere HTML-Seiten.

  • /layout/html/
    Eine einfache Übersicht, in der jeder Eintrag als Zeile in einer Tabelle dargestellt ist.

  • /layout/tablerefs/
    HTML-Ausgabe mit jedem Eintrag als Zeile in einer Tabelle und einer zusätzlichen JavaScript-Suchfunktion.

  • /layout/tablerefsabsbib/
    Ähnelt TableRefs. Enthält auch die BibTeX-Quelle und die Kurzbeschreibung der Publikation.

  • /layout/docbook/
    Dies ist eine XML-Ausgabe gemäß dem DocBook-Schema.

  • /layout/endnote/
    Ausgabe in RIS, welches von dem Literaturverwaltungsprogramm EndNote verwendet wird.

  • /layout/dblp/
    DBLP exportiert Ihre Datensätze in eine DBLP-konforme XML-Struktur.

  • /layout/text/
    BibTeX-Ausgabe.