[{SET lang_de='URL-Syntax'}]

%%information ''__Advice:__ This page contains information intended for developers and technically experienced users.''%%

!!!URL-Syntax
This page contains all information about the [{$jspwiki.projname}] URL syntax. You can click on all the links on this page to see an example of the outputs. 

\\
[{TableOfContents title='Table of contents'}]

\\


!!General pages


* __[/|Bib:]__ \\ Home page of [{$jspwiki.projname}], shows the 50 recently posted public entries. \\ \\
* __[/popular|Bib:/popular]__ \\ Shows the 100 most often posted entries of the last 100.000 public posts. \\ \\
* __[/help_en|Bib:/help_en]__ \\ The help homepage. \\ \\
* __[/help_de/FAQ|Bib:/help_de/FAQ]__ \\ A page with the frequently asked questions (FAQ) and their answers. \\ \\
*__[/user/jaeschke|Bib:/user/jaeschke]__ \\ Shows all public posts of the user ''jaeschke''. \\ \\
*__[/user/jaeschke/web|Bib:/user/jaeschke/web]__ \\ Shows all public posts with the tag ''web'' of the user ''jaeschke''. \\ \\
*__[/user/jaeschke/web+api|Bib:/user/jaeschke/web+api]__ \\ Shows all public posts with the tag ''web'' and the tag ''api'' of the user ''jaeschke''. \\ \\
*__[/myHome|Bib:/myBibSonomy]__\\ Link to the list of your own bookmarks and bibliographic references. \\ \\
*__[/myBibTeX|Bib:/myBibTeX]__ \\ Link to the BibTeX list of all your own bibliographic references. \\ \\
*__[/myRelations|Bib:/myRelations]__ \\ Link to the list of your own relations. \\ \\
*__[/myDocuments|Bib:/myPDF]__ \\ Link to your own collection of full texts (PDF, PS, TXT, DJV or DJVU). \\ \\
*__[/myDuplicates|Bib:/myDuplicates]__ \\ Link to your own duplicates. \\ \\


!!Parameters for sorting
When you see a page with publication/bookmark lists in [{$jspwiki.projname}], you are able to sort them by adding one or more of the following parameters behind the URL. 
Here's a list of exisiting parameters: \\ \\
* __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|Bib:/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|http://www.bibsonomy.org/] and [PUMA|http://puma.uni-kassel.de/].

*__[/post_bookmark|Bib:/post_bookmark]__ \\On this page you can:
** enter a URL to post a bookmark. \\ \\

*__[/post_bibtex|Bib:/post_bibtex]__ \\ 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

[{$jspwiki.projname}] 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|Bib:/author/hotho]__\\Shows all public posts with the author Hotho.\\ \\
*__[/author/stumme+hotho+schmitz|Bib:/author/stumme+hotho+schmitz]__\\Shows all publications published by these authors.\\ \\
*__[/author/stumme+hotho+!schmitz|Bib:/author/stumme+hotho+!schmitz]__
 or __[/author/stumme+hotho+%21schmitz|Bib:/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|Bib:/author/hotho/clustering]__\\Shows all posts with the tag 'clustering' and the author Hotho.\\ \\
*__[/author/stumme/sys:user:hotho|Bib:/author/stumme/sys:user:hotho]__\\Shows all publications of the author Stumme in Hotho's collection.\\ \\
*__[/author/stumme+hotho+!schmitz+sys:year:2002-2007+sys:user:hotho/folksonomy|Bib:/author/stumme+hotho+!schmitz+sys:year:2002-2007+sys:user:hotho/folksonomy]__\\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|Bib:/author/stumme/sys:group:kde]__\\Shows all publications of the author Stumme in the collections of all group members of the group 'kde'.\\ \\


!Author search: year of publication

A [system tag|How-to use TAGs] can restrict your (author) search result to a specific year or range of years. Four formats are available: \\ \\

*__[/author/stumme+sys:year:2007|Bib:/author/stumme+sys:year:2007]__\\Returns all publications of the author Stumme of the year 2007.\\ \\
*__[/author/stumme+sys:year:2003-2007|Bib:/author/stumme+sys:year:2003-2007]__\\Returns all publications of the author Stumme between 2003 and 2007.\\ \\
*__[/author/stumme+sys:year:-2005|Bib:/author/stumme+sys:year:-2005]__\\Returns all publications of the author Stumme until the year 2005.\\ \\
*__[/author/stumme+sys:year:1997-|Bib:/author/stumme+sys:year:1997-]__\\Returns all publications of the author Stumme since 1997. \\ \\

!!Friends pages

You get an introduction about visibility on the page [friends|Add contacts]. In the following section, the most important URLs about friends are listed. \\
\\
 
*__[/friends|Bib:/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|Bib:/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|Bib:/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+api|Bib:/friend/jaeschke/web+api]__\\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|Join a group with same reading interests]. In the following section, the most important URLs about groups are listed. \\
\\
*__[/groups|Bib:/groups]__\\Shows all groups of the system.\\ \\
*__[/group/kde|Bib:/group/kde]__\\Shows all posts of members of the group 'kde', if you are a member of the group.\\ \\
*__[/group/kde/web|Bib:/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+api|Bib:/group/kde/web+api]__\\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|Bib:/relevantfor/group/kde]__\\Shows all posts relevant for the members of the group.\\ \\
*__[/followers|Bib:/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 
*__[/tag/web|Bib:/tag/web]__\\Shows all public posts with the tag 'web'.\\ \\
*__[/tag/web+api|Bib:/tag/web+api]__\\Shows all public posts with the tag 'web' and the tag 'api'.\\ \\


!!Relations and Tags
* __[/api/tags/data|http://www.bibsonomy.org/api/tags/data]__\\Shows all related tags to 'data'.\\ \\
* __[/api/tags/data?relation=related|http://www.bibsonomy.org/api/tags/data?relation=related]__\\Shows all related tags to 'data'.\\ \\
* __[/api/tags/data?relation=similar|http://www.bibsonomy.org/api/tags/data?relation=similar]__\\Shows all similar tags to 'data'.\\ \\


!!Relations and concept pages
*__[/relations/schmitz|Bib:/relations/schmitz]__\\Shows all relations of the user ''schmitz''.\\ \\
*__[/concept/user/schmitz/event|Bib:/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 pages
*__[/search/web|Bib:/search/web]__\\Shows all public posts 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+api|Bib:/search/web+api]__\\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+-api|Bib:/search/web+-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+user:jaeschke|Bib:/search/web+user: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+api+user:jaeschke|Bib:/search/web+api+user: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+-api+user:jaeschke|Bib:/search/web+-api+user: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|Bib:/mySearch]__\\This page offers a quick search in your collection. \\ \\

!!Viewable pages

You get an introduction about visibility on the pages [friends|Add contacts] and [group functions|Join a group with same reading interests]. In the following section, the most important URLs about visibility are listed. \\ \\

*__[/viewable/public|Bib:/viewable/public]__\\Shows all your posts which you set viewable for ''public''. \\ \\
*__[/viewable/public/web|Bib:/viewable/public/web]__\\Shows all your posts with the tag 'web' which you set viewable for ''public''.\\ \\
*__[/viewable/public/web+api|Bib:/viewable/public/web+api]__\\Shows all your posts with the tag 'web' and the tag 'api' which you set viewable for ''public''.\\ \\
*__[/viewable/private|Bib:/viewable/private]__\\Shows all your posts which you set viewable for ''private''.\\ \\
*__[/viewable/private/web|Bib:/viewable/private/web]__\\Shows all your posts with the tag 'web' which you set viewable for ''private''.\\ \\
*__[/viewable/private/web+api|Bib:/viewable/private/web+api]__\\Shows all your posts with the tag 'web' and the tag 'api' which you set viewable for ''private''.\\ \\
*__[/viewable/friends|Bib:/viewable/friends]__\\Shows all your posts which you set viewable for ''friends''.\\ \\
*__[/viewable/friends/web|Bib:/viewable/friends/web]__\\Shows all your posts with the tag 'web' which you set viewable for ''friends''.\\ \\
*__[/viewable/friends/web+api|Bib:/viewable/friends/web+api]__\\Shows all your posts with the tag 'web' and the tag 'api' which you set viewable for ''friends''.\\ \\
*__[/viewable/kde|Bib:/viewable/kde]__\\Shows all posts (if you are allowed to see them) which were set viewable for the group 'kde'.\\ \\
*__[/viewable/kde/web|Bib:/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+api|Bib:/viewable/kde/web+api]__\\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'.\\ \\


!!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|Bib:/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|Bib:/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|Bib:/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
*__[/basket|Bib:/basket]__ \\ Here you can manage publication posts you picked with the "pick" button. \\ \\
*__[/export/|Bib:/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
*__[/publrss/|Bib:/publrss/]__ \\ Presents an RSS feed of the main publication page.
*__[/burst/|Bib:/burst/]__ \\ [{$jspwiki.projname}] [BuRST|http://www.cs.vu.nl/~pmika/research/burst/BuRST.html] feed for the main publication page. \\ \\
*__[/aparss/|Bib:/aparss/]__ \\ RSS feed in [APA|http://www.apa.org/] style. \\ \\

!Reference metadata and formatting
*__[/bib/|Bib:/bib/]__ \\ BibTeX format of all publications of the main publication page. \\ \\
*__[/bib/user/beate|Bib:/bib/user/beate]__ \\ BibTeX format of all publications of the publication page of the user beate. \\ \\
*__[/endnote/|Bib:/endnote/]__ \\ EndNote format of the publications of the main page. \\ \\

!HTML formatting
*__[/publ/|Bib:/publ/]__ \\A simple layout where entries are shown as a list in a table. \\ \\
*__[/publ/?notags=1|Bib:/publ/?notags=1]__ \\ Suppresses the [{$jspwiki.projname}] tags in the HTML output. \\ \\

!Semantic web formatting
*__[/swrc/|Bib:/swrc/]__ \\ RDF output according to the [SWRC ontology|http://ontoware.org/swrc/]. \\ \\

!!URL or BibTeX pages
*__[/url/d1bb7b3f6cafafa7b418f9f356ff2e83|Bib:/url/d1bb7b3f6cafafa7b418f9f356ff2e83]__ \\ Shows all public bookmark posts of the URL with the MD5 hash d1bb7b3f6cafafa7b418f9f356ff2e83. \\ \\
*__[/url/d1bb7b3f6cafafa7b418f9f356ff2e83/jaeschke|Bib:/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|Bib:/bibtex/1d28c9f535d0f24eadb9d342168836199]__ \\ Shows all public publication posts with the [hashkey|Bib:/help/doc/inside.html] 1d28c9f535d0f24eadb9d342168836199. The used hash is the Inter-Hash. \\ \\
*__[/bibtex/25854a71547051543dd3d3d5e2e2f2b67/steff83|Bib:/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. [{$jspwiki.projname}] provides a Tag JSON Feed belonging to a BibTeX post. \\ \\
*__[/json/tags/bibtex/1d28c9f535d0f24eadb9d342168836199|Bib:/json/tags/bibtex/1d28c9f535d0f24eadb9d342168836199]__ \\ Provides A JSON output containing all tags related to the [publication|Bib:/bibtex/1d28c9f535d0f24eadb9d342168836199] with the Inter-Hash 1d28c9f535d0f24eadb9d342168836199. [{$jspwiki.projname}] offers the possibility to retrieve a publication by its BibTeX key. \\ \\
*__[/bibtexkey/Wille82|Bib:/bibtexkey/Wille82]__ \\ Returns publications which have the BibTeX key ''Wille82''. \\ \\
*__[/bibtexkey/wille82+sys:user:Stumme|Bib:/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|Bib:/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|Bib:/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 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:__\\ \\

*__[/uri/url/d1bb7b3f6cafafa7b418f9f356ff2e83|Bib:/uri/url/d1bb7b3f6cafafa7b418f9f356ff2e83]__ \\ Shows all bookmarks with the specified hash. \\ \\
*__[/uri/bibtex/2b8b87c78e9e27a44aacde0402c642bff|Bib:/uri/bibtex/2b8b87c78e9e27a44aacde0402c642bff]__ \\ Shows all BibTeX entries with the specified hash. \\ \\
*__[/uri/bibtexkey/hjss06bibsonomy/jaeschke|Bib:/uri/bibtexkey/hjss06bibsonomy/jaeschke]__ \\ Shows all BibTeX entries with the specified key of the user ''jaeschke''. \\
*__[/uri/author/hotho|Bib:/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:

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

!!Jabref layouts

The [export page|Bib:/export/] gives an overview on all available Jabref layouts. \\

*__[/layout/simplehtml/|Bib:/layout/simplehtml/]__ \\ HTML layout without any header or footer. Useful for integrating publication lists into other HTML pages. \\ \\
*__[/layout/html/|Bib:/layout/html/]__ \\ A simple layout where entries are shown as a list in a table. \\ \\
*__[/layout/tablerefs/|Bib:/layout/tablerefs/]__ \\ HTML output with each entry shown as a list in a table and an additional JavaScript search function. \\ \\
*__[/layout/tablerefsabsbib/|Bib:/layout/tablerefsabsbib/]__ \\ Similar to TableRefs. Also includes the BibTeX source and the abstract of the publication. \\ \\
*__[/layout/docbook/|Bib:/layout/docbook/]__ \\ This is an XML output according to the DocBook schema. \\ \\
*__[/layout/endnote/|Bib:/layout/endnote/]__ \\ Output in RIS format which is used by EndNote, a bibliography management tool. \\ \\
*__[/layout/dblp/|Bib:/layout/dblp/]__ \\ DBLP exports your records to a DBLP conformable XML structure. \\ \\
*__[/layout/text/|Bib:/layout/text/]__ \\ BibTeX output. \\ \\ 

\\ \\