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).
Table of Contents
- URL-Syntax
- Allgemeine Seiten
- Parameter zum Sortieren
- Verwaltungsseiten
- Autorenseiten
- Autorensuche: Erscheinungsjahr
- Freundeseiten
- Gruppenseiten
- Tagseiten/Schlagwortseiten
- Relationen und Tags
- Relationen und Begriffsseiten
- Suchseiten
- Sichtbare Seiten
- Behandlung von Duplikaten
- Export von Seiten
- RSS Feeds
- Referenz-Metadaten und Formatierung
- HTML-Formatierung
- Semantic Web-Formatierung
- URL- oder BibTeX-Seiten
- Inhaltsvereinbarungsseiten
- Jabref-Layouts
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+api
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.
- /myDocuments
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 Paramter 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
- Werte (können durch | verknüpft werden):
- sortPageOrder - Reihenfolge der Sortierung
- Werte:
- asc - aufsteigend
- desc - absteigend
- Werte:
- duplicates
- Werte:
- yes - Erlaube Duplikate
- no - Entferne Duplikate aus der Ergebnisansicht
- Werte:
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:
- /postBookmark
Auf dieser Seite können Sie:- eine URL eingeben, um einen Lesezeicheneintrag zu generieren.
- 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.
- /author/hotho
Zeigt alle Einträge mit dem Autor Hotho.
- /author/stumme+hotho+schmitz
Zeigt alle Publikationen, die von diesen Autoren veröffentlicht wurden.
- /author/stumme+hotho+!schmitz oder /author/stumme+hotho+%21schmitz
Gibt den Namen eines Autors an, der nicht Teil der gesuchten Publikationen sein soll, z.B. zeige alle Publikationen an, die von Stumme und Hotho geschrieben sind, aber nicht von Schmitz.
- /author/hotho/clustering
Zeigt alle Einträge mit dem Tag 'clustering' und dem Autor Hotho.
- /author/stumme/sys:user:hotho
Zeigt alle Publikationen des Autors Stumme in Hothos Sammlung.
- /author/stumme+hotho+!schmitz+sys:year:2002-2007+sys:user:hotho/folksonomy
Diese Kombination von Suchergebnissen zeigt alle Publikationen der Autoren Stumme und Hotho, aber nicht Schmitz in den Jahren 2002 bis 2007 in der Sammlung des Benutzers Hotho, denen der Tag 'folksonomy' zugeordnet wurde.
- /author/stumme/sys:group:kde
Zeigt alle Publikationen des Autors Stumme in der Sammlung aller Gruppenmitglieder der Gruppe 'kde'.
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:
- /author/stumme+sys:year:2007
Zeigt alle Publikationen des Autors Stumme des Jahres 2007.
- /author/stumme+sys:year:2003-2007
Zeigt alle Publikationen des Autors Stumme zwischen 2003 und 2007.
- /author/stumme+sys:year:-2005
Zeigt alle Publikationen des Autors Stumme bis zum Jahr 2005.
- /author/stumme+sys:year:1997-
Zeigt alle Publikationen des Autors Stumme seit 1997.
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+api
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+api
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#
- /tag/web
Zeigt alle öffentlichen Einträge mit dem Tag (Schlagwort) 'web'.
- /tag/web+api
Zeigt alle öffentlichen Einträge mit dem Tag 'web' und dem Tag 'api'.
Relationen und Tags#
- /api/tags/data
Zeigt alle Tags, die in Relation zu 'data' stehen.
- /api/tags/data?relation=related
Zeigt alle Tags, die in Relation zu 'data' stehen.
- /api/tags/data?relation=similar
Zeigt alle Tags, die 'data' ähnlich sind.
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+api
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+-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+user: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+api+user: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+-api+user: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+api
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+api
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+api
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+api
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#
- /basket
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#
- /publrss/
Zeigt einen RSS-Feed der Publikationen-Hauptseite.
- /burst/
PUMA BuRST-Feed für die Publikationen-Hauptseite.
- /aparss/
RSS Feed im APA-Format.
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.
Semantic Web-Formatierung#
- /swrc/
RDF-Ausgabe gemäß der SWRC-Ontologie.
URL- oder BibTeX-Seiten#
- /url/d1bb7b3f6cafafa7b418f9f356ff2e83
Zeigt alle öffentlichen PUMA-Lesezeicheneinträge der URL mit dem MD5-Hash d1bb7b3f6cafafa7b418f9f356ff2e8.
- /url/d1bb7b3f6cafafa7b418f9f356ff2e83/jaeschke
Zeigt die PUMA-Lesezeicheneinträge des Benutzers jaeschke mit dem MD5-Hash d1bb7b3f6cafafa7b418f9f356ff2e83.
- /bibtex/1d28c9f535d0f24eadb9d342168836199
Zeigt alle öffentlichen PUMA-Publikationseinträge mit dem Hashkey 1d28c9f535d0f24eadb9d342168836199. Der benutzte Hash ist der Inter-Hash.
- /bibtex/25854a71547051543dd3d3d5e2e2f2b67/steff83
Zeigt den PUMA-Publikationseintrag des Benutzers steff83 mit dem Hashkey 25854a71547051543dd3d3d5e2e2f2b67. Der benutzte Hash ist der Intra-Hash. PUMA liefert einen Tag-JSON-Feed, der zu einem BibTeX-Eintrag gehört.
- /json/tags/bibtex/1d28c9f535d0f24eadb9d342168836199
Liefert eine JSON-Ausgabe. Diese enthält alle Schlagwörter, welche in Beziehung mit der Publikation stehen, die dem Inter-Hash 1d28c9f535d0f24eadb9d342168836199 entsprechen. PUMA bietet die Möglichkeit, eine Publikation anhand ihres BibTex-Schlüssels abzurufen.
- /bibtexkey/Wille82
Liefert Publikationen mit dem BibTex-Schlüssel Wille82.
- /bibtexkey/wille82+sys:user:Stumme
Liefert Publikationen mit dem BibTex-Schlüssel Wille82 aus der Sammlung des Benutzers Stumme.
- /bibtexkey/hjss06bibsonomy+sys%3Auser%3Ajaeschke
Zeigt alle Einträge mit dem vorgegebenen BibTex-Schlüssel hjss06bibsonomy des Benutzers jaeschke. Haben Sie mehr als einen Eintrag mit dem gleichen BibTeX-Schlüssel, so erhalten Sie eine Liste aller Treffer.
- /bibtexkey/journals/jacm/HopcroftU69/dblp
Sie können die BibTex-Semantik benutzen, um auf Einträge zu verweisen, die wir von DBLP spiegeln, sobald Sie gelernt haben, wie DBLP seine BibTeX-Schlüssel erzeugt.
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:
- /uri/url/d1bb7b3f6cafafa7b418f9f356ff2e83
Zeigt alle Lesezeichen mit dem bestimmten Hash.
- /uri/bibtex/2b8b87c78e9e27a44aacde0402c642bff
Zeigt alle BibTeX-Einträge mit dem bestimmten Hash.
- /uri/bibtexkey/hjss06bibsonomy/jaeschke
Zeigt alle BibTeX-Einträge mit dem bestimmten Schlüssel des Benutzers jaeschke.
- /uri/author/hotho
Zeigt alle BibTeX-Einträge des Autors hotho.
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 Literaturverwaltungprogramm EndNote verwendet wird.
- /layout/dblp/
DBLP exportiert Ihre Datensätze in eine DBLP-konforme XML-Struktur.
- /layout/text/
BibTeX-Ausgabe.