Quelltext der Seite Vorlage:Google Books/Doku

{{DU}}__NOTOC__
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. Mit dem gesetzten Parameter ''plainurl'' erhält man die einfache URL ohne Linktext.

== Parameter ==
{| class="prettytable"
|-
! 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 <code>q=</code> aus der [[w: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 [[w: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 [[w:Pagina|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 [[w:Pagina|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>&dq=(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 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?
| ''Vorschau''
| optionaler Text, beispielsweise um den Nutzer auf eine Volltextversion hinzuweisen; Standardtext ist „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 von Amerika|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 [[w: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: [[w:Friedrich Ehrenberg#Literatur|Friedrich Ehrenberg#Literatur]]
|-
| plainurl
| [[Datei:Symbol OK.svg|zentriert|16px|Ja]]
| [[Datei:Symbol OK.svg|zentriert|16px|Ja]]
| Gibt nur die URL ohne Linktext zurück.
|
|
|}

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

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

: <code><nowiki>{{</nowiki>Google Books | 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> | plainurl=<1><nowiki>}}</nowiki></code>

 <nowiki>{{</nowiki>Google Books
 | 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>
 | plainurl=<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 [[w:Hilfe:Einzelnachweise|Einzelnachweisen]] mitten im Text.

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

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

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

=== Verweis in Kombination mit der Vorlage:Buch ===

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

<pre>
{{Buch
| Autor  = Lautenbach, Ernst
| Titel  = Lexikon Goethe-Zitate
| Verlag = Iudicium
| Ort    = München
| Jahr   = 2004
| ISBN   = 978-3-89129-800-8
| Online =
  {{Google Books
  | BuchID   = eP11MZrBLVcC
  | plainurl = 1 
  }}
}}
</pre>
→ {{Buch
| Autor=Lautenbach, Ernst| Titel=Lexikon Goethe-Zitate| Verlag=Iudicium| Ort=München| Jahr=2004| ISBN=978-3-89129-800-8| Online=
  {{Google Books
  | BuchID   = eP11MZrBLVcC
  | plainurl = 1 
  }}
}}
<!--<code><nowiki>* {{Google Books
| Suchbegriff = römisches Münzwesen
| BuchID      = css1AAAAMAAJ&pg=RA1-PA645
| Linktext    = Magazin für die neue Historie und Geographie
| Land        = US
}}</nowiki></code>
* {{Google Books
| 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>
{{Buch
| Autor  = Witzel, Georg
| Titel  = Catechismvs Ecclesiae, Lere und Handelunge des heiligen Christenthumbs
| Ort    = Mainz
| Verlag = Behem
| Jahr   = 1542
| Seiten = 516
| Online =
  {{Google Books
  | BuchID   = YDg8AAAAcAAJ
  | Seite    = 516
  | Hervorhebung = dritten geschlecht
  | plainurl = 1 
  }}
}}
</pre>
→ {{Buch| Autor= Witzel, Georg| Titel=Catechismvs Ecclesiae, Lere und Handelunge des heiligen Christenthumbs| Ort=Mainz| Verlag=Behem| Jahr=1542| Seiten=516| Online=
  {{Google Books
  | BuchID   = YDg8AAAAcAAJ
  | Seite    = 516
  | Linktext = Volltext
  | Hervorhebung = dritten geschlecht
  | plainurl = 1 
  }}
}}

== TemplateData ==

<templatedata>
{ "description": "",
  "params": {
     "Suchbegriff":
        { "label":       "Suchbegriff",
          "description": "Parameter q= 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 id= 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 „&pg=RA(Bandnummer)“.",
          "type":        "number",
          "required":    false },
     "Seite":
        { "label":       "Seitenzahl",
          "description": "Nur in Verbindung mit „BuchID“, ohne „SeitenID“. In der URL zu finden als „&pg=PA(Seitenzahl)“ oder „&pg=RA(Bandnummer)-PA(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 „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 „&pg=“ 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 [[w:Pagina|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 „&dq=(Hervorhebung)“. 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.",
          "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 Verweise hintereinander.",
          "type":        "boolean",
          "required":    false },
     "plainurl":
        { "label":       "Nur URL",
          "description": "Gibt nur die URL ohne Linktext zurück.",
          "type":        "boolean",
          "required":    false }
      }
}
</templatedata>

<includeonly>[[Kategorie:Vorlagen:Zitation]]</includeonly>