Quelltext der Seite Vorlage:Google Buch/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
Diese Vorlage verlinkt auf die [[w:Google Bücher|Google Buchsuche]].

Dabei muss in der Vorlage genau ''einer'' der beiden nachfolgend erläuterten Parameter ''Suchbegriff'' oder ''BuchID'' ausgefüllt werden. Andernfalls erscheint eine Fehlermeldung mit einem entsprechenden Korrekturhinweis.

Optional kann ein Linktext angegeben werden, andernfalls wird der Seitenname verwendet.

Unter [[w:Wikipedia:Technik/Browser/Bookmarklet#Google Buchsuche]] findet sich ein [[w:Bookmarklet]], mit dem man die Vorlage automatisch mit Werten aus dem aktuell angezeigten Buch befüllen kann.

== Parameter ==
{| class="wikitable"
|- class="hintergrundfarbe5"
! Parameter
! Suche
! Buch/Seite
! Beschreibung
! Standardwert
! Hinweis
|-
| Suchbegriff
| [[Datei:Symbol OK.svg|zentriert|16px|Ja]]
| [[Datei:No-Symbol.svg|zentriert|16px|Nein]]
| Nach welchen Suchbegriffen soll gesucht werden?
|
| Parameter <tt>q=</tt> aus der [[Uniform Resource Locator#Query|URL]] (darf nur angegeben werden, wenn der Parameter „BuchID“ in der Vorlage nicht verwendet wird), weitere Parameter der URL können ebenfalls angehängt werden.
|-
| BuchID
| [[Datei:No-Symbol.svg|zentriert|16px|Nein]]
| [[Datei:Symbol OK.svg|zentriert|16px|Ja]]
| Auf welches Buch soll verwiesen werden?
|
| Parameter <tt>id=</tt> aus der [[Uniform Resource Locator#Query|URL]] (darf nur angegeben werden, wenn der Parameter „Suchbegriff“ in der Vorlage nicht verwendet wird), weitere Parameter der URL können ebenfalls angehängt werden.
|-
| Band
| [[Datei:No-Symbol.svg|zentriert|16px|Nein]]
| [[Datei:Question mark3.svg|zentriert|15px|Optional]]
| Auf welchen Band soll verwiesen werden?
|
| Nur in Verbindung mit „BuchID“, ohne „SeitenID“. In der URL zu finden als „<tt>&pg=RA</tt>(Bandnummer)“.
|-
| Seite
| [[Datei:No-Symbol.svg|zentriert|16px|Nein]]
| [[Datei:Question mark3.svg|zentriert|15px|Optional]]
| Auf welche Seite soll verwiesen werden?
|
| Nur in Verbindung mit „BuchID“, ohne „SeitenID“. In der URL zu finden als „<tt>&pg=PA</tt>(Seitenzahl)“ oder „<tt>&pg=RA</tt>(Bandnummer)<tt>-PA</tt>(Seitenzahl)“. Wenn man weiterblättert, kann es bei der Link-URL hinter dem Kettensymbol zwei Angaben geben, dann ist die zweite die passende. Die im Werk gedruckte [[Pagina]] ist irrelevant; sie kann übereinstimmen, wenn die OCR-Technik es richtig erkannt hat. Bei speziellen Seitenangaben, die nicht dem Muster „<tt>PA</tt>(Seitenzahl)“ entsprechen, kann der Parameter „SeitenID“ genutzt werden.
|-
| SeitenID
| [[Datei:No-Symbol.svg|zentriert|16px|Nein]]
| [[Datei:Question mark3.svg|zentriert|15px|Optional]]
| Auf welchen Teil/Seite soll verwiesen werden?
|
| Nur in Verbindung mit „BuchID“, statt der Parameter „Band“ und „Seite“, für Seitenangaben, die nicht dem Muster „<tt>PA</tt>(Seitenzahl)“ entsprechen. Es wird alles angegeben, was zwischen „<tt>&pg=</tt>“ und dem nächsten „<tt>&</tt>“ oder „<tt>#</tt>“ kommt, also etwa „<tt>&pg=PT(Teilezahl)&</tt>“, „<tt>&pg=RA(Band)-PT(Teilzahl)#v=onepage</tt>“, „<tt>&pg=PP(Seitenzahl)&</tt>“ (für PrefacePage, „Vorwortseite“), „<tt>&pg=RA(Zahl)-PR(Zahl)&</tt>“. Grund: Nicht immer ist eine [[Pagina]] vorhanden (Kunstbücher, Vorwörter, Index, Spaltennummerierung, etc.) und nicht immer wird sie von der OCR-Technik erkannt.
|-
| Hervorhebung
| [[Datei:No-Symbol.svg|zentriert|16px|Nein]]
| [[Datei:Question mark3.svg|zentriert|15px|Optional]]
| Welche Worte sollen hervorgehoben werden?
|
| Nur in Verbindung mit „BuchID“. In der URL zu finden als „<tt>&dq=(Hervorhebung)</tt>“. Werden mehrere Wörter getrennt angegeben, so werden alle Wörter individuell markiert. Für die Hervorhebung von Phrasen muss der Suchbegriff in Hochkommata eingeschlossen werden.
|-
| Linktext
| [[Datei:Question mark3.svg|zentriert|15px|Optional]]
| [[Datei:Question mark3.svg|zentriert|15px|Optional]]
| Welcher Text soll im Link angezeigt werden?
| ''Eingeschränkte Vorschau''
| optionaler Text, beispielsweise um den Nutzer auf eine Volltextversion hinzuweisen; Standardtext ist „Eingeschränkte Vorschau“
|-
| Land
| [[Datei:Question mark3.svg|zentriert|15px|Optional]]
| [[Datei:Question mark3.svg|zentriert|15px|Optional]]
| Ist das Buch nur über einen Proxy eines bestimmten Landes abrufbar?
|
| gültige Werte sind derzeit: <tt>US</tt> für die [[Vereinigte Staaten|USA]]
|-
| KeinText
| [[Datei:Question mark3.svg|zentriert|15px|Optional]]
| [[Datei:Question mark3.svg|zentriert|15px|Optional]]
| Verhindert die Ausgabe der Zeichenkette „in der [[Google Bücher|Google Buchsuche]]“
|
| Dieser Parameter sollte nur bei Aufzählungen, das heißt mehrere Verweise hintereinander, genutzt werden. Gültige Werte sind alle nicht leeren Angaben. Beispiel: [[Friedrich Ehrenberg#Literatur]]
|}

== Kopiervorlagen ==
: <code><nowiki>{{</nowiki>Google Buch | Suchbegriff= | Linktext= | Land=<US> | KeinText=<j><nowiki>}}</nowiki></code>

 <nowiki>{{</nowiki>Google Buch
 | Suchbegriff=
 | Linktext=
 | Land=<US>
 | KeinText=<j>
 <nowiki>}}</nowiki>

: <code><nowiki>{{</nowiki>Google Buch | BuchID= | Band=<Nr aus pg=RA> | Seite=<Nr aus pg=PA> | SeitenID=<PT(Teilezahl), RA(Band)-PT(Teilzahl), PP(Seitenzahl)> | Hervorhebung= | Linktext= | Land=<US> | KeinText=<1><nowiki>}}</nowiki></code>

 <nowiki>{{</nowiki>Google Buch
 | BuchID=
 | Band=<Nr aus pg=RA>
 | Seite=<Nr aus pg=PA>
 | SeitenID=<PT(Teilezahl), RA(Band)-PT(Teilzahl), PP(Seitenzahl)>
 | Hervorhebung=
 | Linktext=
 | Land=<US>
 | KeinText=<1>
 <nowiki>}}</nowiki>

== Beispiele ==

=== Suche ===
<pre>
{{Google Buch
| Suchbegriff = Mommsen
}}
</pre>
→ {{Google Buch
| Suchbegriff = Mommsen
}}

=== Verweis auf ein bestimmtes Werk, mit eigenem Linktext ===
<pre>
{{Google Buch
| BuchID   = ojYGAAAAQAAJ
| Linktext = Geschichte des römischen Münzwesens
}}
</pre>
→ {{Google Buch
| BuchID   = ojYGAAAAQAAJ
| Linktext = Geschichte des römischen Münzwesens
}}

<pre>
{{Google Buch
| BuchID   = css1AAAAMAAJ
| Seite    = 645
| Linktext = Magazin für die neue Historie und Geographie
| Land     = US
}}
</pre>
→ {{Google Buch
| BuchID   = css1AAAAMAAJ
| Seite    = 645
| Linktext = Magazin für die neue Historie und Geographie
| Land     = US
}}

=== Verweis in Kombination mit der Vorlage:Literatur (Empfehlung) ===
Empfohlen wird die Verwendung in Kombination mit der [[Vorlage:Literatur]], da so auch Meta-Informationen über die [[COinS]]-Einträge verfügbar gemacht werden. Die Vorlage:Google Buch wird hierbei nur zur einfacheren Formatierung des Online-Parameters genutzt, diese dient zur Angabe von online verfügbaren Quellen.

<pre>
{{Literatur
| Autor  = Ernst Lautenbach
| Titel  = Lexikon Goethe-Zitate
| Verlag = Iudicium
| Ort    = München
| Jahr   = 2004
| ISBN   = 3-89129-800-5
| Online =
  {{Google Buch
  | BuchID   = eP11MZrBLVcC
  }}
}}
</pre>
→ {{Literatur
| Autor=Ernst Lautenbach| Titel=Lexikon Goethe-Zitate| Verlag=Iudicium| Ort=München| Jahr=2004| ISBN=3-89129-800-5| Online=
  {{Google Buch
  | BuchID   = eP11MZrBLVcC
  }}}}
<!--<code><nowiki>* {{Google Buch
| Suchbegriff = römisches Münzwesen
| BuchID      = css1AAAAMAAJ&pg=RA1-PA645
| Linktext    = Magazin für die neue Historie und Geographie
| Land        = US
}}</nowiki></code>
* {{Google Buch
| Suchbegriff = römisches Münzwesen
| BuchID      = css1AAAAMAAJ&pg=RA1-PA645
| Linktext    = Magazin für die neue Historie und Geographie
| Land        = US
}}-->

=== Verweis auf ein bestimmtes Werk, mit Hervorhebung bestimmter Worte ===
<pre>
{{Literatur
| Autor  = Georg Witzel
| Titel  = Catechismvs Ecclesiae, Lere und Handelunge des heiligen Christenthumbs
| Verlag = Behem
| Jahr   = 1542
| Seiten = 516
| Online =
  {{Google Buch
  | BuchID   = YDg8AAAAcAAJ
  | Seite    = 516
  | Linktext = Volltext
  | Hervorhebung = dritten geschlecht
  }}
}}
</pre>
→ {{Literatur
| Autor=Georg Witzel| Titel=Catechismvs Ecclesiae, Lere und Handelunge des heiligen Christenthumbs| Verlag=Behem| Jahr=1542| Seiten=516| Online=
  {{Google Buch
  | BuchID   = YDg8AAAAcAAJ
  | Seite    = 516
  | Linktext = Volltext
  | Hervorhebung = dritten geschlecht
  }}}}

== Helferlein ==
Das deutschsprachige Programm [http://hbz-da.de/wikipedia/lifo.php ''lifo''] (Literaturformatierer) konvertiert Weblinks aus [[Leitmedium|Leit-]] und anderen Medien in ein Wikipedia-konformes Format. Im Fall der Website der Google Buchsuche (books.google) gibt das Tool eine den [[WP:Zitierregeln]] konforme Literaturangabe zusammen mit einem durch {{Vorlage|Google Buch}} formatierten Verweis auf die Google Buchsuche aus. Bei älteren Büchern, die bereits als Volltext zugänglich sind, muss ggf. <code style="white-space: nowrap">| Linktext = Volltext</code> ergänzt werden. Über ein Formular können Fehlermeldungen oder Verbesserungsvorschläge zum Suchergebnis eingegeben werden. Das Programm wird ständig verbessert und aktualisiert.

== Weitere Informationen ==
{{Wikisource|Wikisource:Google Book Search}}

== Wartung ==
* [[:Kategorie:Wikipedia:Vorlagenfehler/Vorlage:Google Buch]] – Sammlung von Artikeln mit nicht unterstützten Parametern oder fehlenden Pflichtparametern

<includeonly>
{{Lua-Vorlage|TemplatePar #check}}

[[Kategorie:Vorlage:Datenbanklink]]
</includeonly>