[{SET lang_en='Typo3'}]

!!!In TYPO3 einbinden

Wenn Sie TYPO3 in der Version 1.0 bis 5.9 verwenden, dann können Sie die [BibSonomy TYPO3-Extension|http://typo3.org/extensions/repository/view/ext_bibsonomy] nutzen, um Publikationslisten aus [{$jspwiki.projname}] in Ihre Webseite zu integrieren. In TYPO3 v6.0 gab es viele bedeutende Änderungen am TYPO3-System. Daher haben wir eine komplett neue Extension entwickelt, die auf TYPO3 Flow basiert. Bitte nutzen Sie für alle TYPO3-Instanzen ab v6.0 die folgende Extension: [BibSonomy CSL (ext_bibsonomy_csl)|http://typo3.org/extensions/repository/view/ext_bibsonomy_csl].

Mit der Extension können Sie nicht nur Publikationslisten in TYPO3 laden, Sie können auch das Aussehen mittels CSL Stylesheets (Citation Style Language) definieren. Damit Sie schnell starten können, haben wir der Extension bereits ein paar vordefinierte CSL Stylesheets beigelegt. Sie können diese aber auch gerne jederzeit anpassen oder aber eigene Stylesheets entwickeln. Außerdem können Sie ebenfalls Ihre Tagcloud aus [{$jspwiki.projname}] in Ihre Webseite integrieren.

\\
[{TableOfContents }]
\\

!! Installation

Um [{$jspwiki.projname}] CSL zu installieren, melden Sie sich bei ihrer TYPO3-Instanz als Administrator an und suchen Sie über __Extension Manager => Import Extensions__ nach der Extension __ext_bibsonomy_csl__ und importieren Sie diese.
\\
[{ Image src='1.png' width='100%' align='left' style='display:inline; float:none;' }] 
\\
Nach erfolgreichem Import wird die Extension unter __"Verfügbare Extensions"__ angezeigt. Klicken Sie auf das __+__-Symbol, um es zu aktivieren.
\\ \\
[{ Image src='2.png' width='100%' align='left' style='display:inline; float:none;' }]
\\ \\

----


!! Publikationslisten hinzufügen mit dem Frontend Plugin

Nachdem Sie die Extension importiert und aktiviert haben, können Sie Publikationslisten erstellen. Fügen Sie dazu der Seite, auf der die Publikationsliste erscheinen soll, ein neues Plugin hinzu - wählen Sie aus der Liste __"[{$jspwiki.projname}] Publication List"__.
\\
[{ Image src='3.png' width='100%' align='left' style='display:inline; float:none;' }] 
\\
Im Reiter __"General"__ tragen Sie einen Titel für die Publikationsliste ein.
\\ \\
[{ Image src='4.png' width='100%' align='left' style='display:inline; float:none;' }] 
\\
Wählen Sie den Reiter __"Plugin"__ an und nehmen Sie die gewünschten Einstellungen vor. Sie können zwischen ''user'', ''group'' oder ''viewable'' wählen, um den Inhalt aus [{$jspwiki.projname}] zu wählen. Detaillierte Informationen finden Sie [hier|http://www.bibsonomy.org/help_en/URL%20Scheme%20Semantics].

__Beispiel:__ Sie wollen Ihre eigene Publikationsliste einbinden. Dazu wählen Sie zunächst unter __"Content Source": "user"__. Tragen Sie dann den gewünschten (Ihren) Nutzernamen unter __"Insert the id of user ..."__ ein. Dann können Sie die Einträge der Publikationsliste über Schlagworte filtern (select content via tags). Um nur eigene Einträge anzeigen zu lassen, verwenden Sie den [Systemtag|SystemTags] __myown__. Sie können zudem die Anzahl der angezeigten Publikationen begrenzen sowie mittels Freitext filtern.
\\ \\
[{ Image src='5.png' width='100%' align='left' style='display:inline; float:none;' }] 

\\ \\
__WARNUNG:__ Bitte beachten Sie, dass die Extension Ihre gesamte Publikationsliste darstellt, wie Sie sie in [{$jspwiki.projname}] sehen (auch __private__ Publikationen). Wenn Sie z. B. an eine Publikation __ein Dokument angehängt__ haben, dann wird dieses auch in der Publikationsliste angezeigt. Dadurch können für Sie urheberrechtliche Konsequenzen entstehen. Wir empfehlen Ihnen daher für die Nutzung einen zusätzlichen Account anzulegen, mit dem Sie in [{$jspwiki.projname}] nur die TYPO3-Publikationen verwalten.
\\ \\
Im Reiter __"Layout"__ können Sie die Gestaltung der Publikationsliste anpassen. Dies geschieht durch Citation Style Language (CSL), das ist eine frei verfügbare XML-basierte Auszeichnungssprache. Eine große Liste an frei verfügbaren CSL-Vorlagen finden Sie hier: [http://www.zotero.org/styles/|http://www.zotero.org/styles/].
\\ \\
[{ Image src='6.png' width='100%' align='left' style='display:inline; float:none;' }] 
\\
Im dritten und letzten Reiter __"Login"__ müssen Sie ihre [{$jspwiki.projname}] API-Daten hinterlegen. Nur so kann sich die TYPO3 Extension bei [{$jspwiki.projname}] anmelden und Ihre Daten abrufen. Ihre API-Daten finden Sie [hier|Bib:/settings].
\\ \\

----


!! Tagcloud hinzufügen mit dem Frontend Plugin

Sie können Ihren Webseiten nicht nur Publikationslisten hinzufügen, sondern auch Ihre [{$jspwiki.projname}] Tagcloud. Fügen Sie dazu der Seite, auf der die Tagcloud erscheinen soll, ein neues Plugin hinzu. Wählen Sie aus der Liste __"Bibsonomy Tag Cloud"__.
\\
[{ Image src='7.png' width='100%' align='left' style='display:inline; float:none;' }]
\\
Wie bei __"Publikationsliste hinzufügen"__ können Sie auch hier zwischen verschiedenen Modi wählen.
\\ \\
[{ Image src='8.png' width='100%' align='left' style='display:inline; float:none;' }]
\\ \\


----

!! CSL Styles mit dem Backend Module verwalten

TYPO3-Extensions sind klassisch in Frontend- und Backend-Module unterteilt. Die Frontend-Module __"Publikationsliste hinzufügen"__ und __"Tagcloud hinzufügen"__ wurden bereits erklärt. In diesem Abschnitt soll es um das Backend-Modul gehen, mit dem Sie die CSL-Stylesheets verändern können. 

Bereits mit der Extension-Installation wird eine Reihe von CSL-Stylesheets ausgeliefert. Um weitere Stylesheets hinzuzufügen, erstellen Sie einen neuen Ordner im Seitenbaum und nennen diesen __"CSL Styles"__. Wählen Sie diesen Ordner dann aus, klicken Sie auf __"Neu"__ und wählen Sie __"Add a custom style"__.

Es gibt drei Wege, um neue Stylesheets hinzuzufügen.

# Geben Sie den XML-Quellcode direkt in das Textfeld ein und klicken Sie dann auf __"Save"__.
# Geben Sie in das Textfeld die URL des CSL-Stylesheets ein und klicken Sie auf __"Import"__.
# Laden Sie ein CSL-Stylesheet von Ihrem Computer hoch und klicken Sie auf __"Upload"__.
\\
[{ Image src='9.png' width='100%' align='left' style='display:inline; float:none;' }]
\\
Um eine Vorschau zu erhalten, klicken Sie auf __"Show Styles"__.
\\ \\
[{ Image src='10.png' width='100%' align='left' style='display:inline; float:none;'}]
\\
CSL-Stylesheets löschen Sie wie gewohnt über das Mülleimersymbol in TYPO3.

\\ \\