Quelltext der Seite Benutzer:PerfektesChaos/js/citoidWikitext

<noinclude>{{aewi.Seitenordnung
| Quelle = Wikipedia
| URL = {{int:Gast-de.wikipedia-url}}
| Zusatz = Benutzer:
| Obereinordnung2 = Kategorie:•PerfektesChaos, js, citoidWikitext
}}
----</noinclude>
{{nobots}}
[[Datei:WikiEditor Cite.svg|rand|70px|rechts|Button]]
[[JavaScript]] [[Wikipedia:Technik/Skin/Benutzerskripte/Hinweise|Benutzerskript]] – automatisches Ausfüllen von Zitationsvorlagen –&nbsp;{{Vorlage|Literatur}} und {{Vorlage|Internetquelle}} etc.&nbsp;– mittels [[Zotero]]-Expertise und dem [[Wikipedia:Technik/Labs/Citoid|Citoid-Server der WMF]].

Bei einer nach der [[Cursor]]position im Bearbeitungsfeld stehenden Publikationsbezeichnung wird versucht, die Metadaten dazu zu erlangen; und im Erfolgsfall dies mittels geeigneter ausgefüllter Zitationsvorlage in den [[Wikitext]] eingefügt. Bei auskunftsfreudigen Zielseiten genügen zwei Mausklicks.

== Installation ==
Folgende Zeile in die [[Spezial:MyPage/common.js|persönliche common.js]] einfügen:
<syntaxhighlight lang="javascript" copy>
mw.loader.load( "https://en.wikipedia.org/w/index.php?title=User:PerfektesChaos/js/citoidWikitext/r.js&action=raw&bcache=1&maxage=86400&ctype=text/javascript" );
</syntaxhighlight>

=== Kompatibilität ===
Aktiviertes [[JavaScript]] ist zwangsläufig erforderlich.
* Der Browser muss [[Cross-Origin Resource Sharing]] (CORS) unterstützen, was bei allen gängigen und aktuellen großen Browsern der Fall ist.<ref name="CORS" />
* [[Wikipedia:Technik/Text/Edit/CodeMirror|CodeMirror]] wird berücksichtigt; ebenso die Gadgets [[Wikipedia:Technik/Text/Edit/wikEd|wikEd]], [[Benutzer:Schnark/js/edithelper|edithelper@Schnark]] und [[Benutzer:Schnark/js/syntaxhighlight|syntaxhighlight@Schnark]].
* Beide Arten von [[Hilfe:Symbolleisten|Werkzeugleisten]] (2006 und 2010) werden unterstützt; auch ganz ohne Werkzeugleiste.
* [[Wikipedia:Technik/MediaWiki/LivePreview|LivePreview]] ohne Bedeutung.
* Skin ist ohne Bedeutung.
* Desktop (nicht mobil) dringend empfohlen.
<!-- Fliegelflagel -->

== {{Anker|input-types}} Mögliche Suchwünsche ==
Die spezifischen Publikationsbezeichner sollen zukünftig noch um weitere Typen ergänzt werden.

=== URL ===
Jede beliebige [[Uniform Resource Locator|URL]] (mit mindestens einem Schrägstrich als ''root''-Pfad) kann versuchsweise analysiert werden. Mit einem Leerzeichen, Zeilenumbruch, <code>#</code> oder <code><</code> sowie schließender eckiger Klammer <code>]</code> ist die wirksame URL beendet.

Im ungünstigsten Fall, sofern die Website wenigstens reagiert hatte, kann zumindest die {{Vorlage|Internetquelle}} eingefügt werden, mit vorausgefüllter URL und momentanem Abrufdatum.

Vor der URL kann die öffnende Klammer <code>[</code> stehen.

=== ISBN ===
Folgende Formatvariationen von [[Internationale Standardbuchnummer|ISBN]] werden unterstützt, tolerant gegen Leerzeichen, Groß- und Kleinschreibung ohne Bedeutung; Beispiele:
<div style="font-family:monospace,monospace;">
* ISBN 3-7891-4161-5
* <nowiki>isbn: 9129657520</nowiki>
* <nowiki>isbn = 978-3-577-09102-2</nowiki>
</div>
Zu jeder syntaktisch gültigen ISBN (auch bei fehlerhafter Prüfziffer) wird [[WorldCat]] abgefragt.

Ergänzt wird das je nach der mutmaßlichen Sprache, die sich aus der ISBN ableiten lässt, durch Nationalbibliotheken usw.:
* Deutsch – [[Deutsche Nationalbibliothek]] sowie zurzeit im Südwestdeutschen Bibliotheksverbund
* Englisch – [[Library of Congress]]
* Französisch, niederländisch, polnisch analog
* Weitere Sprachen werden zukünftig besser unterstützt, sobald sich die Qualität der Ergebnisse genauer einschätzen lässt.
* [[#ud-lib|Benutzerdefinierte Bibliothekskataloge]] können allgemein oder je Sprache vereinbart werden.
Während der Auswertung werden zu jeder abgefragten Bibliothek auch Links auf die angefragten Seiten angezeigt; zusätzlich auch zur spezifischen [[Spezial:ISBN-Suche]].

=== DOI ===
[[Digital Object Identifier|DOI]] können beispielsweise in folgenden Formaten spezifiziert werden:
<div style="font-family:monospace,monospace;">
* DOI 10.1000/182
* doi=10.1000/182
* <nowiki>[[doi:10.1000/182]]</nowiki>
* {{Vorlage|DOI|2=10.1000/182}}
</div>
Es wird weitergeleitet auf wissenschaftliche Zeitschriften, deren Seiten häufig gut aufbereitete Informationen bereitstellen.

=== Standard-IDs: arXiv, PMID, PMC ===
Die Formate für [[arXiv]], [[PubMed]] sind ähnlich wie für [[#ISBN|ISBN]] usw.:
<div style="font-family:monospace,monospace;">
* <nowiki>[[arxiv:0704.0220]]</nowiki>
* arXiv astro-ph/0301118
* PMID 1234567
* pmid= 7654321
* pmid: 1234
* PMC 123
* {{Vorlage|PMC|456}}
</div>
Die wissenschaftlichen Zeitschriften, die derartige IDs anbieten, sind oft mit semantischen Informationen ausgestattet.

=== Bibliothekskataloge: DNB, LCCN, OCLC ===
Die Formate für [[Deutsche Nationalbibliothek|DNB]], [[Library of Congress|LCCN]], [[Online Computer Library Center|OCLC]] sind vergleichbar aufgebaut:
<div style="font-family:monospace,monospace;">
* {{Vorlage|DNB|820224316}}
* DNB 454663196
* dnb=770531741
* DNB:993443176
* LCCN 2004-059084
* {{Vorlage|OCLC|633555891}}
</div>
Die semantische Aufbereitung der Kataloge ist unterschiedlich detailliert.

=== [[Vorlage:Google Buch]] ===
Zu dieser Vorlage wird die URL gebildet und ausgewertet; oft mit gutem Ergebnis.

=== Zotero-Unterstützung ===
Eine Aufzählung der zurzeit unterstützen Websites oder aber inhaltlicher Formate wird auf [https://git.wikimedia.org/tree/mediawiki%2Fservices%2Fzotero%2Ftranslators GIT] oder für (angemeldete?) [[Wikipedia:Technik/Phabricator|Phabricator]]-Benutzer im Repositorium {{Phab|project=GZTT|title=GZTT}} gelistet. Die derzeitigen Domains sind unter [[Wikipedia:Technik/Labs/Citoid/Zotero]] aufgelistet.

Wissenschaftliche Zeitschriften, das deutsche Bundesgesetzblatt, die ''[[Neue Zürcher Zeitung]]'' und viele andere deutschsprachige wie internationale Zeitungen und Magazine sowie die Software verschiedener Bibliothekskataloge werden besonders unterstützt, so dass dafür gut strukturierte Ergebnisse zu erwarten sind.

== Interaktive Bedienung ==
=== Geeignete Seiten ===
Auf den nachstehenden Seiten wird im Quelltext-Bearbeitungsmodus das Skript aktiv:
* Alle Artikel.
* Alle eigenen Benutzer-Unterseiten.
* Vorlagen, deren Titel mit <code>Bib</code> beginnt.
* [[Wikipedia:Spielwiese]].<ref>Erst die Spielwiesenseite besuchen, danach im selben Browser-Tab zum Bearbeiten öffnen.</ref>
Weitere Seiten können zusätzlich [[#ud-pages|benutzerdefiniert]] vorgegeben werden.

=== Werkzeuglinks ===
Wenn eine [[Hilfe:Symbolleisten|grafische Werkzeugleiste]] vorhanden ist, wird dort ein Button eingefügt, sonst in der linken Spalte des Portals:
{| class="wikitable"
|-
| '''Element''' || '''Modus'''
|-
| [[Datei:Button easy cite (1).png|23px|]]
|
* Bearbeiten-Werkzeugleiste
* [[Wikipedia:Technik/Text/Edit/wikEd|wikEd]]
|-
| [[Datei:WikiEditor Cite.svg|23px|]]
|
* Erweiterte Bearbeiten-Werkzeugleiste<br />(„WikiEditor“)
|-
| [[#p-tb|Werkzeugbox]]
| ''ohne Werkzeugleisten''
|-
| <span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; padding: 0 3px;">Citoid</span>
| Nach dem Öffnen der [[#Citoid-Box|Citoid-Box]] oberhalb des Bearbeitungsfeldes.
|}
Der Klick startet sofort die Auswertung des Textes an der Cursorposition und die Abfrage; die [[#Citoid-Box|Citoid-Box]] wird geöffnet.

=== Gesuchte Publikation beschreiben ===
* Standardmäßig wird der Quelltext an der Cursorposition im Bearbeitungsfeld analysiert.
* Wenn ein Textbereich selektiert (markiert) ist, dann dieser.
* {{Anker|input-field}} Nach dem Öffnen der Citoid-Box (meist oberhalb des Bearbeitungsfeldes) kann mit <span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; color: #000000; font-size: 110%; padding: 0 3px;">'''_'''</span> ein [[#input-button|Texteingabefeld]] aktiviert werden. Dann gilt statt der Cursorposition die dortige Eingabe.
Von der Cursorposition an gilt der dort stehende Text. Leerzeichen können geeignet zwischen Schlüsselwörter und Daten eingestreut werden. Die Publikationsbeschreibung wird dort soweit ausgewertet, wie das syntaktisch zu erwarten ist:
* URL bis zum nächsten Leerzeichen, schließende Klammer&nbsp;<code>]</code> oder Zeilenende.
* ID bis zum nächsten Leerzeichen, geeignete Satzzeichen oder Zeilenende; ggf. beginnend mit einem Schlüsselwort wie „ISBN“.
* Vorlageneinbindungen bis zur entsprechenden Pipe&nbsp;<code>|</code>, schließende Klammern&nbsp;<code>}}</code> oder Zeilenende.

Nachstehend ein Bildschirmausschnitt zu dieser allerersten Phase; eine geeignete Cursorposition im Bearbeitungsfeld ist blau markiert:
<div style="background: #E0FFE0; border: #3CB371 2px dashed; padding: 0.5em; width: 100%;">
<div style="background: #FFFACD; border: #4169E1 1px solid; font-family: monospace; padding-bottom: 4em; padding-left: 0.5em; padding-top: 0.2em; margin-right: 0;">
== Literatur ==<br />Wiki-Lexikon: <span style="color: #4169E1; font-family: sans-serif; font-size: 150%;">|</span>ISBN 978-3-577-09102-2 (von 2008)
</div>
</div>

=== Citoid-Box ===
Nach dem ersten Werkzeug-Klick wird (in der Regel unmittelbar oberhalb des Bearbeitungsfeldes) eine Box geöffnet. Sie kann auch wieder geschlossen werden. Durch Interaktion mit anderen Systemen für die Benutzeroberfläche ([[Hilfe:Symbolleisten|WikiEditor]]) könnte sie auch unterhalb des Textfeldes stehen.

Ganz links darin befindet sich ein Button <span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; padding: 0 3px;">Citoid</span> zum Starten von Abfragen. Die Buttons in den Werkzeugleisten behalten ihre Wirkung; sie ist identisch.

Als [[Tooltip]] wird auf dem Button die aktuelle Versionsbezeichnung dieses Skripts angezeigt.

=== Steuerelemente ===
In der einmal geöffneten [[#Citoid-Box|Citoid-Box]] sind rechts oben die folgenden Knöpfe verfügbar (von links nach rechts):
{| class="wikitable"
|-
| '''Button''' || '''Wirkung'''
|-
| <span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; color: #0000FF; font-size: 110%; padding: 0 3px;">'''0'''</span>
| Bearbeitung abbrechen, Citoid-Box leeren
|- id="input-button"
| <span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; color: #000000; font-size: 110%; padding: 0 3px;">'''_'''</span>
| [[#input-field|Texteingabefeld]] für Publikationsbeschreibung anzeigen
|-
| <span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; color: #00A000; font-size: 110%; padding: 0 3px;">'''?'''</span>
| Diese Hilfeseite in einem neuen Browser-Fenster anzeigen (aber immer in demselben)
|-
| <span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; color: #FF0000; padding: 1px 3px;">'''X'''</span>
| Bearbeitung abbrechen, Citoid-Box schließen.
|}

=== Abruf und Probleme ===
In der [[#Citoid-Box|Citoid-Box]] werden nach Beginn des Abrufs folgende Symbole angezeigt:
{| class="wikitable"
|-
| '''Symbol''' || '''Bedeutung'''
|-
| [[Datei:Ajax-loader.png|30px|Ajax-Animation]]
| Citoid-Server wird kontaktiert.
|-
| <span style="color:#808080">'''???'''</span>
| Es konnte kein [[#input-types|Publikationsbezeichner]] erkannt werden.
|-
| <span style="color:#FF0000">'''!?!?!'''</span>
| Es wurde ein Publikationsbezeichner gefunden, die zugehörigen Daten sind jedoch ungültig.
|-
| <span style="color:#208020">'''*'''</span>
| Ergebnisse liegen vor.
|-
| <span style="color:#FF0000">''':-('''</span>
| Ein Server antwortete nicht (WMF oder Zielseite) oder forderte eine Autorisierung.
|}
{{Anker|ext-links}}Zusätzlich werden Verlinkungen <span style="color:#3366CC">[1] [2]</span> usw. angezeigt. Sie bilden genau diejenigen Webseiten ab, die zurzeit automatisch kontaktiert werden. Diese Seiten werden in neuen Browser-Fenstern angezeigt (aber immer in denselben).

Nachstehend ein Bildschirmausschnitt während der Kontaktaufnahme mit dem Server:
<div style="background: #E0FFE0; border: #3CB371 2px dashed; padding: 0.5em; width: 100%;">
<div style="background: #FFFFFF; border: #808080 2px solid; padding: 1em; padding-bottom: 3em; margin-right: 0;">
<span style="float: right; white-space: pre;"><span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; color: #0000FF; font-size: 110%; padding: 0 3px;">'''0'''</span><span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; color: #000000; font-size: 110%; padding: 0 3px;">'''_'''</span><span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; color: #00A000; font-size: 110%; padding: 0 3px;">'''?'''</span><span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; color: #FF0000; padding: 1px 3px;">'''X'''</span></span>
<span class="plainlinks" style="float: left; margin-bottom: 2em; white-space: pre;"><span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; padding: 0 3px;" title="Versionsbezeichnung">Citoid</span> <span style="margin:1em;">[[Datei:Ajax-loader.png|30px|Ajax-Animation]]</span> [http://www.worldcat.org/search?q=isbn:9783577091022 &#91;1&#93;] [http://swb.bsz-bw.de/DB=2.1/CMD?ACT=SRCHA&IKT=1007&TRM=9783577091022 &#91;2&#93;] [https://portal.dnb.de/opac.htm?method=simpleSearch&query=9783577091022 &#91;3&#93;] [[Spezial:ISBN-Suche/9783577091022|ISBN]] 9783577091022</span>
</div>
<div style="background: #FFFACD; border: #4169E1 1px solid; font-family: monospace; margin-top: 1em; padding-bottom: 4em; padding-left: 0.5em; padding-top: 0.2em; margin-right: 0;">== Literatur ==<br />Wiki-Lexikon: <span style="color: #4169E1; font-family: sans-serif; font-size: 150%;">|</span>ISBN 978-3-577-09102-2 (von 2008)
</div>
</div>
<div style="clear:both"></div>

== Ergebnisse ==
Grundsätzlich hängt die Qualität des Ergebnisses davon ab, was in der Zielseite an Informationen verfügbar ist; ob dies bereits semantisch strukturiert aufbereitet wurde (etwa bei einer wissenschaftlichen Zeitschrift) oder die Formatierung Zotero bereits bekannt ist.

Wenn ein Ergebnis vorliegt, wird die dafür geeignetste Vorlage bestimmt und in einer der folgenden Formatierungen an der Cursorposition eingefügt, bzw. ein selektierter (markierter) Textbereich ersetzt:
{| class="wikitable"
|-
| '''Button''' || '''Wirkung'''
|-
| <span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; font-size: 110%; padding: 0 3px;">kompakt</span>
|
* Alle Parameter, für die Daten vorliegen, und Pflichtparameter bzw. solche, die immer auch zum späteren Ausfüllen bereitstehen sollen.
* Alle Angaben lückenlos in einem Block.
Vorgesehen für die Verwendung innerhalb des laufenden Texts.
|-
| <span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; font-size: 110%; padding: 0 3px;">&lt;ref>&lt;/ref></span>
| Wie eben kompakt, aber in <code>&lt;ref></code> und <code>&lt;/ref></code> einschließen.
|-
| <span style="border: 2px outset #DDDDDD; padding: 0 3px; background-color: ButtonFace; border-radius:3px; font-size: 110%; white-space: nowrap;">== Literatur ==</span>
| (Nur wenn Vorlage sich dafür eignet)
* Alle Standardparameter angeben (neben den mit Werten belegten auch solche, die oft später ausgefüllt werden)
* In einer neuen Zeile ein <code>*</code> voranstellen
* Zeilenweise eintragen und einrücken
|-
| <span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; font-size: 110%; padding: 0 3px;">&lt;references></span>
|
* Alle Standardparameter wie eben zeilenweise eintragen
* Einschließen in <code>&lt;ref name=""></code> und <code>&lt;/ref></code>
Vorgesehen für die Verwendung innerhalb eines Blocks <code>&lt;references></code> am Ende des Artikels.
|}

Nach dem Einfügen müssen alle Parameterwerte auf Plausibiltät geprüft und ggf. korrigiert oder manuell ergänzt werden:
* Das Auslesen von Personennamen aus der Website gelingt nicht immer richtig.
* Angaben können völlig fehlen.
* Werte können in den falschen Feldern gelandet sein.
* Werte können völliger Nonsens sein.
* Groß- und Kleinschreibung, Abkürzungen, Typografie müssen ggf. nachgearbeitet werden.
In der Citoid-Box sind noch [[#ext-links|Links auf alle abgefragten Seiten]] vorhanden, die in eigenen Browser-Fenstern geöffnet werden und mittels derer fehlende Angaben manuell identifiziert und kopiert werden können.

Dieses Skript hat weder einen Einfluss auf die inhaltliche Qualität der Ergebnisse noch auf die Verfügbarkeit des Citoid-Servers oder die auszuwertenden Zielseiten.

Nachstehend ein Bildschirmausschnitt zu dieser Phase; ein Klick auf einen der Buttons fügt das Resultat an der blau markierten Cursorposition ein:
<div style="background: #E0FFE0; border: #3CB371 2px dashed; padding: 0.5em; width: 100%;">
<div style="background: #FFFFFF; border: #808080 2px solid; padding: 1em; margin-right: 0;">
<span style="float: right; white-space: pre;"><span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; color: #0000FF; font-size: 110%; padding: 0 3px;">'''0'''</span><span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; color: #000000; font-size: 110%; padding: 0 3px;">'''_'''</span><span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; color: #00A000; font-size: 110%; padding: 0 3px;">'''?'''</span><span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; color: #FF0000; padding: 1px 3px;">'''X'''</span></span><span class="plainlinks" style="float: left; margin-bottom: 0.5em; white-space: pre;"><span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; padding: 0 3px;" title="Versionsbezeichnung">Citoid</span><span style="color: #208020; font-size: 125%; margin-left: 1em; margin-right: 1em;">'''*'''</span> [http://www.worldcat.org/search?q=isbn:9783577091022 &#91;1&#93;] [http://swb.bsz-bw.de/DB=2.1/CMD?ACT=SRCHA&IKT=1007&TRM=9783577091022 &#91;2&#93;] [https://portal.dnb.de/opac.htm?method=simpleSearch&query=9783577091022 &#91;3&#93;] [[Spezial:ISBN-Suche/9783577091022|ISBN]] 9783577091022</span>
<span style="margin-left: 1em; margin-top: 0.5em; white-space: pre;"><span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; font-size: 110%; padding: 0 3px;">kompakt</span> <span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; font-size: 110%; padding: 0 3px;">&lt;ref>&lt;/ref></span> <span style="border: 2px outset #DDDDDD; padding: 0 3px; background-color: ButtonFace; border-radius:3px; font-size: 110%; white-space: nowrap;">== Literatur ==</span> <span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; font-size: 110%; padding: 0 3px;">&lt;references></span>
</span>
</div>
<div style="background: #FFFACD; border: #4169E1 1px solid; font-family: monospace; margin-top: 1em; padding-bottom: 4em; padding-left: 0.5em; padding-top: 0.2em; margin-right: 0;">
== Literatur ==<br />Wiki-Lexikon: <span style="color: #4169E1; font-family: sans-serif; font-size: 150%;">|</span>ISBN 978-3-577-09102-2 (von 2008)
</div>
</div>

Nach einem Klick auf
<span style="border: 2px outset #DDDDDD; padding: 0 3px; background-color: ButtonFace; border-radius:3px; font-size: 110%; white-space: nowrap;">== Literatur ==</span>
wird das Resultat an der Cursorposition eingefügt. Wäre die Textpassage markiert gewesen, dann wäre der markierte Bereich ersetzt worden. Die Links auf die externen Websites sind immer noch vorhanden:
<div style="background: #E0FFE0; border: #3CB371 2px dashed; padding: 0.5em; width: 100%;">
<div style="background: #FFFFFF; border: #808080 2px solid; padding: 1em; padding-bottom: 3em; margin-right: 0;">
<span style="float: right; white-space: pre;"><span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; color: #0000FF; font-size: 110%; padding: 0 3px;">'''0'''</span><span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; color: #000000; font-size: 110%; padding: 0 3px;">'''_'''</span><span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; color: #00A000; font-size: 110%; padding: 0 3px;">'''?'''</span><span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; color: #FF0000; padding: 1px 3px;">'''X'''</span></span><span class="plainlinks" style="float: left; margin-bottom: 0.5em; white-space: pre;"><span style="border: 2px outset #DDDDDD; padding: 0 3px; background-color: ButtonFace; border-radius:3px;" title="Versionsbezeichnung">Citoid</span> <span style="color: #208020; font-size: 125%; margin-left: 1em; margin-right: 1em;">'''*'''</span> [http://www.worldcat.org/search?q=isbn:9783577091022 &#91;1&#93;] [http://swb.bsz-bw.de/DB=2.1/CMD?ACT=SRCHA&IKT=1007&TRM=9783577091022 &#91;2&#93;] [https://portal.dnb.de/opac.htm?method=simpleSearch&query=9783577091022 &#91;3&#93;] [[Spezial:ISBN-Suche/9783577091022|ISBN]] 9783577091022</span>
</div>
<div style="background: #FFFACD; border: #4169E1 1px solid; font-family: monospace; margin-top: 1em; padding-bottom: 4em; padding-left: 0.5em; padding-top: 0.2em; margin-right: 0;">
== Literatur ==<br />
Wiki-Lexikon: <span style="color: #4169E1; font-family: sans-serif; font-size: 150%;">|</span><br />
&#42; {&#123;Literatur<br />
&nbsp; &nbsp;|Autor=<br />
&nbsp; &nbsp;|Hrsg=Tanja Loos, Lexikoninstitut Bertelsmann<br />
&nbsp; &nbsp;|Titel=Das Wikipedia-Lexikon in einem Band: &#91;die meistgesuchten Inhalte der freien Enzyklopädie&#93;<br />
&nbsp; &nbsp;|Sammelwerk=<br />
&nbsp; &nbsp;|Band=<br />
&nbsp; &nbsp;|Nummer=<br />
&nbsp; &nbsp;|Auflage=1.<br />
&nbsp; &nbsp;|Verlag=Wissen-Media-Verl<br />
&nbsp; &nbsp;|Ort=Gütersloh München<br />
&nbsp; &nbsp;|Darum=2008<br />
&nbsp; &nbsp;|Seiten=<br />
&nbsp; &nbsp;|ISBN=978-3-577-09102-2}}<br />
ISBN<nowiki /> 978-3-577-09102-2 (von 2008)
</div>
</div>

== Benutzerkonfiguration ==
Persönliche Anpassungen sind möglich.

=== Anwendungs-Objekt definieren ===
Noch vor der Zeile mit der [[#mw-import|Einbindung]] ist in die [[Spezial:MyPage/common.js|persönliche common.js]] einzufügen:
<syntaxhighlight lang="javascript">
if ( typeof mw.libs.citoidWikitext !== "object" ) {
   mw.libs.citoidWikitext  =  { };
}
</syntaxhighlight>
Danach können individuelle Zuweisungen vorgenommen werden.

=== {{Anker|ud-pages}} Zusätzliche Seiten ===
Es können zusätzlich zu den [[#Geeignete Seiten|Standardseiten]] weitere Seiten vorgegeben werden, die mit Citoid ausgestattet werden sollen.

Die Komponente <code>.pages</code> muss ein ''object'' sein, dessen Komponenten die [[Hilfe:Namensräume#Namensräume der Wikipedia|Nummer des Namensraums]] darstellen und denen als Zeichenkette oder ''object'' ein [[Regulärer Ausdruck]] zugewiesen wird, der alle gewünschten Seitentitel abdeckt.

''Beispiel: Alle Unterseiten von [[Benutzer:Artikelstube]]''
<syntaxhighlight lang="javascript">
if ( typeof mw.libs.citoidWikitext !== "object" ) {
   mw.libs.citoidWikitext  =  { };
}
mw.libs.citoidWikitext.pages = { 2: "^Artikelstube/" };
</syntaxhighlight>
Die <code>2</code> steht für ''Benutzer:'', ''Benutzerin:'' oder ''user:'' und das <code>^</code> fordert, dass der Benutzername wie angegeben beginnen muss. Der <code>/</code> am Ende schränkt auf Unterseiten ein.

=== {{Anker|ud-leading}} Box zu Beginn öffnen ===
Soll die [[#Citoid-Box|Citoid-Box]] bereits beim Öffnen der Bearbeitungsseite geöffnet sein, kann dies wie folgt erreicht werden:
<syntaxhighlight lang="javascript">
if ( typeof mw.libs.citoidWikitext !== "object" ) {
   mw.libs.citoidWikitext  =  { };
}
mw.libs.citoidWikitext.leading = true;
</syntaxhighlight>

=== {{Anker|ud-lib}} Bibliothekskataloge ===
Es können die URL von bevorzugten Bibliothekskatalogen vorgegeben werden, die zusätzlich kontaktiert werden. Für die aktuelle ISBN ist als Platzhalter ein <code>#</code> anzugeben.

''Beispiel: Suche im KOBV-Verbund''
<syntaxhighlight lang="javascript">
if ( typeof mw.libs.citoidWikitext !== "object" ) {
   mw.libs.citoidWikitext  =  { };
}
mw.libs.citoidWikitext.isbn = "http://digibib.kobv.de/cgi-bin/deeplink-from-wikipedia?ISBN=#";
</syntaxhighlight>

Es ist auch möglich, statt einer einzelnen Zeichenkette für eine immer aufzurufende Bibliothek ein Array oder ein Objekt anzugeben, um mehrere URL oder eine für die momentane Publikationssprache spezifische Serie von Bibliotheken zu nennen:
{| class="wikitable"
|-
|+ Komponente <code>.isbn</code>
| '''Datentyp''' || '''Bedeutung'''
|-
| <code>string</code>
| Ein URL-Muster, das immer abgefragt wird.
|-
| <code>Array</code>
| Mehrere <code>string</code> mit URL, die immer abgefragt werden.
|-
| <code>object</code>
|
* Der Bezeichner jeder Komponente ist ein Sprachcode nach [[ISO 639]].
** <code>qqq</code> steht für alle Sprachen.
* Jede Komponente ist ein <code>Array</code> mit URL-Mustern, die für diese Sprache ausgewertet werden.
|}
Insgesamt wird aber jede sich ergebende URL nur einmal abgefragt.

=== {{Anker|ud-l10n}} Sprachanpassung ===
Mit der Komponente <code>.l10n</code> lassen sich alle Textelemente der Benutzeroberfläche anpassen. Das ist für die deutschsprachige Wikipedia kaum erforderlich, sondern zielt auf die übergangsweise Unterstützung fremdsprachiger Projekte ab. Die Komponente <code>.l10n</code> müsste ein Objekt sein, das in gleicher Struktur wie <code>I18N.texts</code> im ''core'' zusätzliche Übersetzungen bereitstellt oder auch vorhandene überschreibt. Allgemein verwendbare Übersetzungen werden mittelfristig allen Anwendern verfügbar gemacht.

=== {{Anker|ud-server}} Alternative Citoid-Server ===
Fachleuten ermöglicht die Komponente <code>.server</code> den Wechsel zu einer anderen URL des Citoid-Dienstes, etwa auf ''wmflabs'' zur Erprobung.

== Codes und Software-Angelegenheiten ==
Siehe [[:en:User:PerfektesChaos/js/citoidWikitext/software|Dokumentation]] in der englischsprachigen Wikipedia.

Die aktuelle Versionsbezeichnung ist als [[Tooltip]] auf dem Button <span style="border: 2px outset #DDDDDD; background-color: ButtonFace; border-radius:3px; padding: 0 3px;" title="Versionsbezeichnung">Citoid</span> in der [[#Citoid-Box|Citoid-Box]] ablesbar.

Es gibt eine [[/Test/]]prozedur zur Prüfung auf Erfüllung der Grundfunktionalität; auch als Tutorial für Menschen, die mit den Fingern lernen.

== Anmerkungen ==
<references>
<ref name="CORS">
Unterstützt wird CORS durch:
* Gecko (Firefox)
* WebKit (Safari, Google Chrome)
* MSHTML/Trident 4.0+ (Internet Explorer ab IE10, möglicherweise bereits IE8/IE9)
* Presto (Opera 12)
Zu Details siehe [[Cross-Origin Resource Sharing #Browser-Unterstützung]].<br /> Konqueror bietet kein CORS.
</ref>
</references>

{{#interlanguagelink:en|User:PerfektesChaos/js/citoidWikitext}}