Quelltext der Seite Vorlage:Google Buch/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
{{TemplateData|JSON=
{ "description": "Verlinkung auf ein Digitalisat bei '''[[Google Books]]'''",
  "params": {
     "Suchbegriff":
        { "label":       "Suchbegriff",
          "description": "Parameter <code>q=</code> aus der URL (darf nur angegeben werden, wenn der Parameter „BuchID“ in der Vorlage nicht verwendet wird), weitere Parameter der URL",
          "type":        "line",
          "suggested":   true,
          "required":    false },
     "BuchID":
        { "label":       "ID des Buches",
          "description": "Parameter <code>id=</code> aus der URL (darf nur angegeben werden, wenn der Parameter „Suchbegriff“ in der Vorlage nicht verwendet wird), weitere Parameter der URL",
          "type":        "line",
          "suggested":   true,
          "required":    false },
     "Band":
        { "label":       "Bandnummer",
          "description": "Nur in Verbindung mit „BuchID“, ohne „SeitenID“. In der URL zu finden als „<code>&pg=RA</code>(Bandnummer)“.",
          "type":        "number",
          "required":    false },
     "Seite":
        { "label":       "Seitenzahl",
          "description": "Nur in Verbindung mit „BuchID“, ohne „SeitenID“. In der URL zu finden als „<code>&pg=PA</code>(Seitenzahl)“ oder „<code>&pg=RA</code>(Bandnummer)<code>-PA</code>(Seitenzahl)“.  Wenn man weiterblättert, kann es bei der Link-URL hinter dem Kettensymbol zwei Angaben geben, dann ist die zweite die passende. Die Angabe in der Vorlage Google Buch erfolgt ohne das in der URL vorangestellte „PA“. 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 „PA(Seitenzahl)“ entsprechen, kann der Parameter „SeitenID“ genutzt werden.",
          "type":        "line",
          "required":    false },
     "SeitenID":
        { "label":       "Seiten-ID",
          "description": "Nur in Verbindung mit „BuchID“, statt der Parameter „Band“ und „Seite“, für Seitenangaben, die nicht dem Muster „PA(Seitenzahl)“ entsprechen. Es wird alles angegeben, was zwischen „<code>&pg=</code>“ und dem nächsten „&“ oder „#“ kommt, also etwa „&pg=PT(Teilezahl)&“, „&pg=RA(Band)-PT(Teilzahl)#v=onepage“, „&pg=PP(Seitenzahl)&“ (für PrefacePage, „Vorwortseite“), „&pg=RA(Zahl)-PR(Zahl)&“. Grund: Nicht immer ist eine [[Pagina]] vorhanden (Kunstbücher, Vorwörter, Index, Spaltennummerierung, etc.) und nicht immer wird sie von der OCR-Technik erkannt.",
          "type":        "line",
          "required":    false },
     "Hervorhebung":
        { "label":       "Hervorhebung",
          "description": "Nur in Verbindung mit „BuchID“. In der URL zu finden als „<code>&q=</code>(Hervorhebung)“. Werden mehrere Wörter getrennt angegeben, so werden alle Wörter individuell markiert. Für die Hervorhebung von Phrasen muss der Suchbegriff in [[Anführungszeichen]] eingeschlossen werden.",
          "type":        "line",
          "required":    false },
     "Linktext":
        { "label":       "Angezeigter Text",
          "description": "optionaler Text, beispielsweise um den Nutzer auf eine Volltextversion hinzuweisen",
          "type":        "line",
          "default":     "Eingeschränkte Vorschau",
          "required":    false },
     "Land":
        { "label":       "Proxy-Abruf",
          "description": "Wenn Buch nur über einen Proxy eines bestimmten Landes abrufbar; zurzeit nur sinnvoll: US",
          "type":        "line",
          "required":    false },
     "KeinText":
        { "label":       "Ohne Herkunft",
          "description": "Verhindert die Ausgabe der Zeichenkette „in der Google-Buchsuche“ – nur bei Aufzählungen, das heißt mehreren Verweisen hintereinander.",
          "type":        "boolean",
          "required":    false }
  },
  "format": "inline half"
}
|TOC=1}}

{{Tausendfach verwendet}}

== Parameter-Details ==
{| class="wikitable"
|- class="hintergrundfarbe5"
! Parameter
! Suche
! Buch/Seite
! Beschreibung
! Hinweis
|-
| Suchbegriff
| [[Datei:Symbol OK.svg|zentriert|16px|Ja]]
| [[Datei:No-Symbol.svg|zentriert|16px|Nein]]
| Nach welchen Suchbegriffen soll gesucht werden?
| Parameter <code>q=</code> 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 <code>id=</code> 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 „<code>&pg=RA</code>(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 „<code>&pg=PA</code>(Seitenzahl)“ oder „<code>&pg=RA</code>(Bandnummer)<code>-PA</code>(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 „<code>PA</code>(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 „<code>PA</code>(Seitenzahl)“ entsprechen. Es wird alles angegeben, was zwischen „<code>&pg=</code>“ und dem nächsten „<code>&</code>“ oder „<code>#</code>“ kommt, also etwa „<code>&pg=PT(Teilezahl)&</code>“, „<code>&pg=RA(Band)-PT(Teilzahl)#v=onepage</code>“, „<code>&pg=PP(Seitenzahl)&</code>“ (für PrefacePage, „Vorwortseite“), „<code>&pg=RA(Zahl)-PR(Zahl)&</code>“. 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 „<code>&q=(Hervorhebung)</code>“. Werden mehrere Wörter getrennt angegeben, so werden alle Wörter individuell markiert. Für die Hervorhebung von Phrasen muss der Suchbegriff in [[Anführungszeichen]] eingeschlossen werden.
|-
| Linktext
| [[Datei:Question mark3.svg|zentriert|15px|Optional]]
| [[Datei:Question mark3.svg|zentriert|15px|Optional]]
| Welcher Text soll im Link angezeigt werden?
| 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: <code>US</code> für die [[Vereinigte Staaten|USA]] oder <code>CH</code> für Google Books [[Schweiz]].
|-
| 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 ==
Es wird gebeten, im Artikeltext den hier gegebenen mehrzeiligen Satz auf eine Zeile zu straffen, um den Gesamt-Quelltext lesbarer zu gestalten, insbesondere bei den [[CW:EN|Einzelnachweisen]] mitten im Text.

=== Suche ===
<syntaxhighlight lang="wikitext">
{{Google Buch
| Suchbegriff = Mommsen
}}
</syntaxhighlight>
→ {{Google Buch
| Suchbegriff = Mommsen
}}

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

<syntaxhighlight lang="wikitext">
{{Google Buch
| BuchID   = css1AAAAMAAJ
| Seite    = 645
| Linktext = Magazin für die neue Historie und Geographie
| Land     = US
}}
</syntaxhighlight>
→ {{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.

<syntaxhighlight lang="wikitext">
{{Literatur
| Autor  = Ernst Lautenbach
| Titel  = Lexikon Goethe-Zitate
| Verlag = Iudicium
| Ort    = München
| Datum  = 2004
| ISBN   = 3-89129-800-5
| Online =
  {{Google Buch
  | BuchID   = eP11MZrBLVcC
  }}
}}
</syntaxhighlight>
→ {{Literatur
| Autor=Ernst Lautenbach| Titel=Lexikon Goethe-Zitate| Verlag=Iudicium| Ort=München| Datum=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 ===
<syntaxhighlight lang="wikitext">
{{Literatur
| Autor  = Georg Witzel
| Titel  = Catechismvs Ecclesiae, Lere und Handelunge des heiligen Christenthumbs
| Verlag = Behem
| Datum  = 1542
| Seiten = 516
| Online =
  {{Google Buch
  | BuchID   = YDg8AAAAcAAJ
  | Seite    = 516
  | Linktext = Volltext
  | Hervorhebung = dritten geschlecht
  }}
}}
</syntaxhighlight>
→ {{Literatur
| Autor=Georg Witzel| Titel=Catechismvs Ecclesiae, Lere und Handelunge des heiligen Christenthumbs| Verlag=Behem| Datum=1542| Seiten=516| Online=
  {{Google Buch
  | BuchID   = YDg8AAAAcAAJ
  | Seite    = 516
  | Linktext = Volltext
  | Hervorhebung = dritten geschlecht
  }}}}

== Wartung ==
* [[:Kategorie:CowboysWiki:Vorlagenfehler/Vorlage:Google Buch]] – Sammlung von Artikeln mit nicht unterstützten Parametern oder fehlenden Pflichtparametern
* Unzulässiger <code>[[#templatedata:Linktext|Linktext]]</code> wird in [[:Kategorie:CowboysWiki:Vorlagenfehler/Parameter:Linktext]] aufgelistet.

== Hilfsmittel ==
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 [[CW: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.

Diese Vorlage stellt für den [[toollabs:templator/|Templator]] Eingabefelder für die einzelnen Parameter bereit.

Unter [[CowboysWiki:Technik/Browser/Bookmarklet #Google-Buchsuche]] findet sich ein {{WP|Bookmarklet}}, mit dem man die Vorlage automatisch mit Werten aus dem aktuell angezeigten Buch befüllen kann.

== Weitere Informationen ==
{{Wikisource|Wikisource:Google Book Search}}
<includeonly>
{{Dokumentation/Lua |Vorlage:GoogleBook #fine |TemplatePar #check |WLink}}

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