Bildgrößenbestimmung
Es gibt mehrere Bildattribute, mit denen Sie die Größe der Bilder in Ihren Paligo-Topics steuern können. Sie können die Attribute zum imagedata
hinzufügen. In den folgenden Abschnitten wird erläutert, wie die Größenwerte eingestellt werden und welche Ergebnisse zu erwarten sind.
Anmerkung
Was üblicherweise als „Höhe“ eines Bildes bezeichnet wird, wird in Paligo als Attribut depth bezeichnet. Dies ist ein Erbe von DocBook, das Paligo als Grundlage für das Paligo-Inhaltsmodell verwendet.
Für Vektorbilder wie SVG sollten Sie nur contentwidth
und contentdepth
verwenden. Diese können auch für bestimmte andere Anwendungsfälle verwendet werden, z. B. wenn Sie einen Abstand um ein Bild wünschen,
siehe Beispiele für die Bildgrößenanpassung.
In den meisten Fällen ist es besser, die Attribute width
und depth
zu verwenden, da sie einfacher vorherzusagen sind. Die contentwidth
und contentdepth
können bei
Bitmap-Bildern unerwartete (aber genaue) Ergebnisse liefern. Dies liegt daran, dass es nicht immer möglich ist, die intrinsische Bildgröße eines Bitmap-Bildes bei der Verarbeitung der Ausgabe zu bestimmen.
Definieren Sie die Bildgröße, indem Sie eines der folgenden Attribute für das Element imagedata
verwenden:
-
width
– legt den Wert für die Breite im Verhältnis zum Viewport fest. -
depth
– legt den Wert für die Tiefe (Höhe) im Verhältnis zum Viewport fest. -
contentwidth
– legt den Breitenwert des Bildes fest und hat keinen Einfluss auf das Viewport. -
contentdepth
– legt den Wert für die Tiefe (Höhe) des Bildes fest und hat keinen Einfluss auf das Viewport. -
scalefit
– hiermit lässt sich die Größe eines Bildes an die jeweils verfügbare Fläche anpassen. Lautet der Wertscalefit="1"
, wird das Bild skaliert (mit demselben Faktor für beide Dimensionen), sodass die Grafik nur innerhalb der verfügbaren Höhe oder Breite passt (je nachdem, was stärker einschränkt). Wird ein anderes Bildgrößenattribut angegeben, bestimmen diese Attribute die Grafikgröße, undscalefit
wird ignoriert.
Das Viewport ist die verfügbare Fläche für das imageobject
auf der Seite. Je nachdem, welches Element auf dem imagedata
verwendet wird, unterscheidet sich das Ergebnis. Wenn Sie das Bild einstellen:
-
width
auf 50 % – das Bild wird so vergrößert, dass es die Hälfte des verfügbaren Platzes auf der Seite einnimmt. -
contentwidth
auf 50 % – das Bild wird auf 50 % seiner ursprünglichen Größe verkleinert.
Mit der Einstellung Bildgröße können Sie die Auflösung der Bilder in Ihrer veröffentlichten HTML5-Ausgabe steuern. Beispielsweise lässt sich die Auflösung verringern, damit die Bilddatei kompakter ist und die Seite schneller geladen wird. Beim Bearbeiten eines HTML5-Layouts ist die Einstellung Bildgröße verfügbar.
Es gibt mehrere Bildattribute, mit denen die Größe von Bildern gesteuert werden kann, siehe Bildgrößenbestimmung.
Anmerkung
Die Einstellung Bildgröße beeinflusst die Auflösung (Bildqualität und Dateigröße) des Bildes, ändert jedoch nicht dessen physische Größe auf der Seite. Dazu können Sie die Attribute width
und contentwidth
verwenden,
die sich im mediaobject
-Element eines Bildes einstellen lassen.
-
Wählen Sie im oberen Menü Layout aus.
-
Wählen Sie das Layout, das Sie aktualisieren möchten, oder Ein Layout erstellen aus.
Tipp
Sie können die URL des Layout-Editors kopieren und in eine neue Registerkarte in Ihrem Browser einfügen. Dies kann nützlich sein, wenn Sie häufig zwischen Ihren Paligo-Inhalten und den Layout-Einstellungen wechseln.
-
Wählen Sie in der Seitenleiste Bilder aus.
-
Scrollen Sie nach unten zu Bildgröße.
-
Drücken Sie Speichern.
Wenn Sie Über das Veröffentlichen den Inhalt, werden die Bilder auf der Grundlage der hinzugefügten Attribute und Werte vergrößert. Sie können Vorschau eines Topics, um zu sehen, wie die Größe in den verschiedenen Ausgaben aussehen wird.
In der Regel sollten Sie nur die width
oder die contentwidth
eines Bildes einstellen. Die depth
oder die contentdepth
(Höhe) wird automatisch berechnet, um die
Bildabmessungen als ursprüngliche Bilddatei beizubehalten. Wenn Sie sowohl width als auch depth einstellen, wird der kleinere Wert verwendet und das Bild entsprechend skaliert.
Es gibt mehrere weitere Attribute, um Breite und Höhe zu steuern. Weitere Informationen über die Möglichkeiten finden Sie unter DocBook Bildgrößenreferenz.
Für die HTML5-Ausgabe können Sie die Funktionen Miniaturansichten und Lightbox für Bilder kombinieren, um kleine Bildversionen zu erhalten, die bei Auswahl vergrößert werden.
Tipp
So erhalten Sie die SVG-Funktionalität in HTML und HTML5:
-
Fügen Sie das Attribut
format
in Panel „Elementattribute“ hinzu und wählen Sie svg im Dropdown-Menü aus. -
Verwenden Sie
contentwidth
undcontentdepth
anstelle von width und depth.
So legen Sie die Attribute für die Bildgröße fest:
-
Wählen Sie das Topic oder die Komponente im Content Manager aus, um es/sie im Editor zu öffnen.
-
Wählen Sie das Bild aus, das Sie vergrößern möchten.
-
Wählen Sie
imagedata
im Menü „Elementstruktur“ und dann Zum Element gehen aus. -
Fügen Sie das Attribut
width
odercontentwidth
im Panel „Elementattribute“ hinzu. -
Stellen Sie den Wert auf die gewünschte Breite in Kombination mit einem der Maßeinheiten für die Bildgrößenbestimmung ein.
-
Drücken Sie Speichern.
Standardmäßig verwendet Paligo eine Nennbreite und -höhe bei der Vorberechnung der prozentualen Skalierung von Bildern. Dadurch könnte es zu Layoutverschiebungen bei HTML5-Helpcenter-Ausgaben kommen und auch Probleme bei der Suchmaschinenoptimierung (SEO) verursachen.
Wenn Sie das Attribut Bildgröße für Ihre HTML5-Ausgabe aktivieren, wendet Paligo bei der Vorberechnung der prozentualen Skalierung von Bildern stattdessen die tatsächliche Breite und Höhe an. Dies beschleunigt das Laden der Webseite und erhöht die Benutzerfreundlichkeit, da der Browser den Seitenaufbau genauer vorausberechnen kann.
Um die Suchmaschinenoptimierung (SEO) und die Benutzererfahrung zu verbessern, kann diese Einstellung in Kombination mit der Einstellung Bildgröße verwendet werden, was die Sichtbarkeit der Website erhöht, siehe Bildauflösung einstellen.
Achtung
Bevor Sie das Attribut Bildgröße aktivieren, müssen Sie prüfen, ob bei der Skalierung der Bilder contentwidth
und/oder contentdepth
verwendet wurde, siehe Nach Attributen suchen.
Falls ja, sollten Sie überlegen, ob Sie
-
die Skalierung für alle Bilder nach Aktivierung dieser Einstellung aktualisieren oder
-
die oben genannten Attribute durch das Attribut
width
ersetzen, bevor Sie diese Einstellung aktivieren.
-
Wählen Sie im oberen Menü Layout aus.
-
Wählen Sie das Layout, das Sie aktualisieren möchten, oder Ein Layout erstellen aus.
Tipp
Sie können die URL des Layout-Editors kopieren und in eine neue Registerkarte in Ihrem Browser einfügen. Dies kann nützlich sein, wenn Sie häufig zwischen Ihren Paligo-Inhalten und den Layout-Einstellungen wechseln.
-
Wählen Sie in der Seitenleiste Bilder aus.
-
Scrollen Sie nach unten zum Attribut Bildgröße.
-
Wählen Sie im Menü Aktivieren aus.
-
Drücken Sie Speichern.
Hier sind einige Beispiele für verschiedene Bildgrößenkombinationen, die Ihnen zeigen sollen, welche unterschiedlichen Auswirkungen die Größenattribute haben können:
In Ihrer HTML5-Ausgabe können Sie verkleinerte Bilder anzeigen, die bei Auswahl vergrößert werden. Die vergrößerte Version des Bildes wird in einer „Lightbox“ angezeigt, einer separaten Anzeige, die Ihre Inhalte überlagert.
Dies ist besonders nützlich, wenn Sie große Bilder haben, die den Benutzern ein besseres Erlebnis bieten würden, wenn sie kleiner wären. Dies wird erreicht, wenn Sie die Größe der Bilder ändern, indem Sie das Attribut width
verwenden oder Miniaturansichten aktivieren und dann die Lightbox-Funktion aktivieren.
Um Lightbox für Bilder verwenden zu können, müssen Sie die Funktion im Layout-Editor aktivieren. Lightbox kann auf Miniaturansichten als auch auf Bildern verwendet werden, deren
Größe mit dem Attribut width
geändert wurde. Klicken Sie auf das Bild unten, um diese Funktion zu testen.
So aktivieren oder deaktivieren Sie die Lightbox-Funktion für alle Bilder in Ihrer HTML5-Ausgabe:
-
Wählen Sie im oberen Menü Layout aus.
-
Wählen Sie das Layout, das Sie aktualisieren möchten, oder Ein Layout erstellen aus.
Tipp
Sie können die URL des Layout-Editors kopieren und in eine neue Registerkarte in Ihrem Browser einfügen. Dies kann nützlich sein, wenn Sie häufig zwischen Ihren Paligo-Inhalten und den Layout-Einstellungen wechseln.
-
Wählen Sie in der Seitenleiste Bilder aus.
-
Setzen Sie das Kontrollkästchen für Lightbox für Bilder auf:
-
Aktiviert wenn alle Blockbilder die Lightbox-Funktion verwenden sollen.
-
Deaktiviert, um die Lightbox-Funktion auszuschalten.
Anmerkung
Wenn Sie die Lightbox-Funktion aktivieren, können Sie entweder alle Blockbilder so einstellen, dass sie Miniaturansichten verwenden, oder Sie können Miniaturansichten einzeln einstellen. Weitere Informationen finden Sie unter Miniaturansichten.
-
-
Drücken Sie Speichern.
Tipp
Die Lightbox-Funktion ist auch für Zendesk-Ausgaben verfügbar, sie ist jedoch anders eingerichtet.
Für Zendesk verfügt Paligo über Asset-Dateien, die in der Zip-Datei enthalten sind, die beim Veröffentlichen in Ihrem Browser heruntergeladen wird. Sie können diese Asset-Dateien in den Abschnitt Assets im Zendesk-Leitfaden hochladen und dann den folgenden Code zum Abschnitt Dokumentenkopf hinzufügen:
<link href="{{asset 'lightbox.min.css'}}" rel="stylesheet" type="text/css" /> <script src="{{asset 'lightbox.min.js'}}"></script> <script src="{{asset 'paligo-zd-lightbox.js'}}"></script>
Sie müssen dies nur einmal tun, wenn Sie zum ersten Mal in Zendesk veröffentlichen, siehe Anpassen von Zendesk-Artikeln mit Javascript.
Wenn Sie den Wert für ein Attribut width
, depth
, contentwidth
oder contentdepth
festlegen, können Sie eine dieser Einheiten verwenden:
- px
-
Wenn keine Einheit angegeben ist, sind Pixel die Standardeinheit.
- pt
-
Punkte entsprechen 1/72 eines Zolls.
- cm
-
Zentimeter
- mm
-
Millimeter
- pc
-
Pica entspricht 1/6 eines Zolls.
- in
-
Zoll
- em
-
Ems (die Schriftgröße des aktuellen umgebenden Elements)
- %
-
Prozentsatz der verfügbaren Seitenfläche für
width
unddepth
ODER Originalbildgröße fürcontentwidth
undcontentdepth
.
Möglicherweise haben Sie Inhalte, die große Bilder benötigen, aber diese Bilder nehmen zu viel Platz auf der Seite ein und erschweren das Lesen des Textes. Eine Möglichkeit, dies bei HTML5-Ausgaben zu handhaben, ist die Verwendung von „Miniaturansichten“. Hier werden große Bilder in einer viel kleineren Größe auf der Seite angezeigt. Wenn Sie Lightbox für Bilder verwenden, können Leser auf die Miniaturansicht klicken, um eine größere Version anzuzeigen.
In Paligo können Sie Alle Bilder als Miniaturansichten festlegen aus dem HTML5-Layout oder Miniaturansichten für einzelne Bilder festlegen.
Anmerkung
Standardmäßig erhält die Miniaturansicht einen abgerundeten Rand und eine maximale Breite und Höhe von 200 Pixeln (px). Dies kann in Ihrem CSS angepasst werden.
Tipp
Wenn Sie in anderen Ausgaben wie PDF veröffentlichen, müssen Sie möglicherweise auch eine bestimmte Breite für das Bild festlegen. Verwenden Sie dazu das Attribut contentwidth
anstatt width
, sonst funktioniert die Miniaturansicht
möglicherweise nicht wie vorgesehen.
Wenn Sie möchten, dass alle Blockbilder als Miniaturansichten in Ihrer HTML5-Ausgabe erscheinen, verwenden Sie die Einstellung Miniaturansichten für alle Medienobjektbilder (Block) verwenden. Dies ist im HTML5-Layout. Dies kann nützlich sein, wenn Sie große Bilder haben, die zu viel Platz auf der Seite einnehmen. Wenn Sie sie als „Miniaturansicht“ einstellen, erscheinen sie viel kleiner. Sie sollten auch die Lightbox-Funktion aktivieren, damit Endbenutzer die Bilder auswählen können, um eine größere Version anzuzeigen.
Wenn Sie die Einstellung aktivieren und veröffentlichen, werden die Bilder als kleinere „Miniaturansichten“ angezeigt. Wir empfehlen Ihnen, auch Lightbox für Bilder zu aktivieren, damit Ihre Leser die „Miniaturansichten“ auswählen können, um eine größere Version anzuzeigen.
Tipp
Wenn nur bestimmte Bilder als Miniaturansichten angezeigt werden sollen, siehe Miniaturansichten für einzelne Bilder festlegen.
-
Wählen Sie im oberen Menü Layout aus.
-
Wählen Sie das Layout, das Sie aktualisieren möchten, oder Ein Layout erstellen aus.
Tipp
Sie können die URL des Layout-Editors kopieren und in eine neue Registerkarte in Ihrem Browser einfügen. Dies kann nützlich sein, wenn Sie häufig zwischen Ihren Paligo-Inhalten und den Layout-Einstellungen wechseln.
-
Wählen Sie in der Seitenleiste Bilder aus.
-
Setzen Sie das Feld Miniaturansichten für alle Medienobjektbilder (Block) verwenden auf:
-
Aktiviert wenn Sie möchten, dass alle Blockbilder als Miniaturansicht erscheinen.
-
Deaktiviert wenn Sie nicht möchten, dass alle Blockbilder als Miniaturansicht erscheinen.
-
-
Drücken Sie Speichern.
Sie können einstellen, dass einzelne Bilder als Miniaturansicht statt in voller Größe angezeigt werden. Dies ist nützlich, wenn Sie die Miniaturansicht nur für bestimmte Bilder verwenden möchten, z. B. besonders große Bilder.
Tipp
Wenn Sie möchten, dass die meisten, aber nicht alle Bilder Miniaturansichten verwenden, kann es schneller sein zu Alle Bilder als Miniaturansichten festlegen, und einige Bilder von der Verwendung als Miniaturansichten auszuschließen, indem Sie ein Attribut role
dem Element mediaobject
hinzufügen und den Wert auf img-thumbnail-reset setzen.
So verwenden Sie die Miniaturansicht für einzelne Bilder:
-
Wählen Sie im oberen Menü Layout aus.
-
Wählen Sie das Layout, das Sie aktualisieren möchten, oder Ein Layout erstellen aus.
Tipp
Sie können die URL des Layout-Editors kopieren und in eine neue Registerkarte in Ihrem Browser einfügen. Dies kann nützlich sein, wenn Sie häufig zwischen Ihren Paligo-Inhalten und den Layout-Einstellungen wechseln.
-
Wählen Sie in der Seitenleiste Bilder aus.
-
Stellen Sie Miniaturansichten für alle Medienobjektbilder (Block) verwenden auf Standard oder Deaktiviert ein.
-
Aktivieren Sie Lightbox für Bilder verwenden, damit Benutzer auf Ihr Miniaturbild klicken können, um es in einem größeren Format anzuzeigen.
-
Drücken Sie Speichern.
-
Wählen Sie das Topic oder die Komponente im Content Manager aus, um es/sie im Editor zu öffnen.
-
Wählen Sie das Bild im Inhalt aus.
-
Entweder Sie tun Folgendes:
-
Wählen Sie Einfügen aus.
-
Wählen Sie Bild aus.
-
Wählen Sie Miniaturansicht erstellen aus.
Paligo ändert die Größe Ihres Bildes im Editor, obwohl es möglicherweise nicht als Miniaturansicht angezeigt wird. Wenn Sie veröffentlichen, wird es in der Ausgabe als Miniaturansicht angezeigt.
oder Sie verfahren folgendermaßen:
-
Wählen Sie das Element
mediaobject
des Bildes im Menü „Elementstruktur“ aus und dann Zum Element gehen. -
Fügen Sie das Attribut
role
im Panel „Elementattribute“ hinzu und setzen Sie seinen Wert aufimg-thumbnail
.Tipp
Wenn bereits ein Attribut
role
für das mediaobject vorhanden ist, trennen Sie die Werte mit einem Semikolon.
-
-
Drücken Sie Speichern.
Wenn Sie Ihren Inhalt veröffentlichen, zeigt Paligo das Bild als Miniaturansicht an. Ihre Benutzer können die Miniaturansicht auswählen, um eine größere Version anzuzeigen (sofern Sie die Lightbox-Funktion in Ihrem Layout aktiviert haben, siehe Schritt 5).