Querverweise und Links
Links und Querverweise kommen in Paligo für verschiedene Zwecke zum Einsatz:
-
Querverweise sind in der Regel eine Art Link, der zu einer Stelle innerhalb der Publikation führt. Das bedeutet, dass die Publikation sowohl das Quellen-Topic als auch das Ziel-Topic enthält. Ein Querverweis kann jedoch auch auf Paligo-Inhalte außerhalb der Publikation verweisen (publikationsübergreifende Links), wenn er von Ausgaben wie Zendesk oder Fluid Topics unterstützt wird.
-
Links verweisen an Speicherorte außerhalb der Publikation, wie z. B. eine Website oder Dokumente im Internet.
Wir empfehlen, Querverweise nur dort zu verwenden, wo sie wirklich notwendig sind. Denn mit Querverweisen erzeugen Sie Abhängigkeiten. Wird aus einem Topic zu einem anderen verlinkt, müssen beide Topics in einer Publikation enthalten sein, ansonsten funktioniert der Link nicht. Infolgedessen sind die Topics voneinander abhängig, was eine jeweils unabhängige Wiederverwendung erschwert.
Tipp
Wenn Sie einen bereits vorhandenen Querverweis ändern möchten, siehe Querverweise bearbeiten.
In einer Publikation gibt es eine Struktur, die auf sämtliche in der Publikation vorhandenen Topics (und Unterpublikationen) verweist. Jeder Verweis auf ein Topic oder eine Unterpublikation wird als „Gabelung“ bezeichnet und verfügt über seine fork:id
. Dies dient lediglich dazu, die
Verbindung zwischen der Publikation und dem Topic/der Unterpublikation aufzuzeigen und auf deren Position hinzuweisen. Sie ist nicht identisch mit der xml:id
des Topics.
Wenn Sie zum Beispiel ein Topic „Sicherheit“ haben, das dreimal in derselben Publikation vorkommt, können Sie für das zweite Vorkommen einen Link zur Gabelung erstellen und dieser Link führt zum zweiten Topic „Sicherheit“. Würden Sie statt auf die Gabelung auf das Topic verlinken, würde der Link immer nur zum ersten Vorkommen dieses Topics führen.
Anmerkung
Es ist möglich, Querverweise auf Elemente innerhalb anderer Topics hinzuzufügen, siehe Link zu Element in anderem Topic.
So fügen Sie einen Querverweis hinzu:
-
Wählen Sie das Topic oder die Komponente im Content Manager aus, um es/sie im Editor zu öffnen.
-
Positionieren Sie den Cursor dort, wo der Link eingefügt werden soll.
Tipp
Alternativ können Sie Text markieren, der als Linkbezeichnung fungieren soll.
-
Wählen Sie die Registerkarte Einfügen im Symbolleiste.
-
Wählen Sie Link und danach Querverweis.
Tipp
Oder verwenden Sie die Tastenkombination Alt + R (Windows) oder Option ⌥ + R (Mac), um den Querverweis hinzuzufügen.
-
Geben Sie einen Text als Linkbezeichnung ein. Lassen Sie das Feld leer, wenn der Linktext mit dem Topic-Titel übereinstimmen soll, siehe Auto-Text für Querverweise.
-
Suchen Sie das Ziel in der Baumstruktur oder verwenden Sie die Schnellsuche.
Tipp
Gestalten Sie Ihre Suche noch effizienter, indem Sie vorgeben, nach welchen Ressourcentypen gesucht werden soll.
-
Wählen Sie, ob der Querverweis auf das topic oder eine fork erfolgen soll.
-
Drücken Sie Speichern.
Anmerkung
Wenn Sie den Querverweistext ändern oder automatischen Text verwenden möchten, wählen Sie diesen aus, um den Querverweis-Editor anzuzeigen. Verwenden Sie ihn, um automatischen Text zu aktivieren oder zu deaktivieren und den Text der Beschriftung zu ändern, siehe auch Auto-Text für Querverweise.
So fügen Sie einen Querverweis zu einem Element hinzu, das sich an anderer Stelle im gleichen Topic befindet:
-
Wählen Sie das Topic oder die Komponente im Content Manager aus, um es/sie im Editor zu öffnen.
-
Positionieren Sie den Cursor dort, wo der Link eingefügt werden soll.
Tipp
Alternativ können Sie Text markieren, der als Linkbezeichnung fungieren soll.
-
Wählen Sie die Registerkarte Einfügen im Symbolleiste.
-
Wählen Sie Link und danach Querverweis.
Tipp
Oder verwenden Sie die Tastenkombination Alt + R (Windows) oder Option ⌥ + R (Mac), um den Querverweis hinzuzufügen.
-
Geben Sie einen Text als Linkbezeichnung ein. Lassen Sie das Feld leer, wenn der Linktext mit dem Topic-Titel übereinstimmen soll, siehe Auto-Text für Querverweise.
Anmerkung
Wenn Sie eine Verknüpfung zu einem Verfahrensschritt oder einer Listennummer herstellen wollen, lassen Sie das Feld Linkbeschriftung leer. Stellen Sie sicher, dass das Kontrollkästchen Auto aktiviert ist, da dies erforderlich ist, damit der Link das Listenelement oder die Schrittnummer anzeigt.
Beachten Sie außerdem, dass der Querverweis beim Hinzufügen als Code-Verweis erscheint. Bei der Veröffentlichung wird er durch die Schrittnummer ersetzt. Sie können vor der Veröffentlichung eine Vorschau anzeigen, siehe Vorschau eines Topics.
-
Wählen Sie die Registerkarte internes Ziel, um ein Element innerhalb Ihres Topics auszuwählen, das derzeit eine
xml:id
hat.Elemente ohne ID werden nicht aufgelistet. Sie können eine ID manuell generieren, siehe IDs für Querverweise).
Anmerkung
Um zur Überschrift eines Unterabschnitts in einem Topic zu verlinken, wählen Sie das
section
-Element des Unterabschnitts aus. Wählen Sie nicht dastitle
-Element aus, da der Link auf den gesamten Abschnitt verweisen soll, nicht nur auf denTitel
. -
Drücken Sie Speichern.
Um herunterladbare Dateien in Ihren Inhalten bereitzustellen, müssen Sie externe Links hinzufügen, die auf diese Dateien auf Ihrem Server verweisen, und ein Skript, das externe Links in herunterladbare Dateien umwandelt.
Ein Download-Link ist ein externer Link, dessen Attribute role
auf download
gesetzt ist. Download-Links funktionieren nicht ohne ein Skript, das sie in herunterladbare Dateien umwandelt.
So fügen Sie einen Download-Link zu einem Topic hinzu:
-
Wählen Sie das Topic oder die Komponente im Content Manager aus, um es/sie im Editor zu öffnen.
-
Positionieren Sie den Cursor dort, wo der Link eingefügt werden soll.
Tipp
Alternativ können Sie Text markieren, der als Linkbezeichnung fungieren soll.
-
Wählen Sie die Registerkarte Einfügen im Symbolleiste.
-
Wählen Sie Link und dann Externer Link.
-
Geben Sie eine Linkbezeichnung und ein Linkziel ein.
-
Wählen Sie Einfügen aus.
-
Wählen Sie den
Link
im Menü „Elementstruktur“ aus und wählen Sie Zum Element gehen. -
Fügen Sie das Attribut
role
im Panel „Elementattribute“ hinzu und setzen Sie seinen Wert aufdownload
. -
Drücken Sie Speichern.
Download-Links funktionieren nur, wenn Sie ein Skript hinzufügen, das sie in herunterladbare Dateien umwandelt:
-
Verwenden Sie zum Erstellen (oder Aktualisieren) der JavaScript-Datei einen Text- oder Code-Editor.
-
Fügen Sie das folgende Skript hinzu:
$(document).ready(function () { var link = document.getElementsByClassName('link download')[0]; $(link).attr("download", true); });
-
Speichern Sie Ihre JavaScript-Datei und stellen Sie sicher, dass sie die Dateierweiterung
.js
hat.
Sie können einen Link zu einer Website oder zu im Internet gehosteten Dokumenten einfügen, indem Sie die URL der Website oder des Dokuments verwenden.
Die Linkbezeichnung ist das, was dem Leser als Link-Text im Topic angezeigt wird. Wenn der Linktext mit seiner URL übereinstimmen soll, lassen Sie das Feld Linkbezeichnung unausgefüllt.
Tipp
Standardmäßig werden externe Links in HTML- und HTML5-Ausgaben in einem neuen Browser-Tab geöffnet.
Wenn Sie möchten, dass externe Links im gleichen Tab geöffnet werden, fügen Sie das Attribut xlink:show
im Panel „Elementattribute“
hinzu und geben Sie als Wert replace
ein.
-
Wählen Sie das Topic oder die Komponente im Content Manager aus, um es/sie im Editor zu öffnen.
-
Positionieren Sie den Cursor dort, wo der Link eingefügt werden soll.
Tipp
Alternativ können Sie Text markieren, der als Linkbezeichnung fungieren soll.
-
Wählen Sie die Registerkarte Einfügen im Symbolleiste.
-
Wählen Sie Link und dann Externer Link.
-
Geben Sie eine Linkbezeichnung und ein Linkziel ein.
Lassen Sie das Feld Linkbezeichnung leer, um die URL anzuzeigen.
-
Wählen Sie Einfügen aus.
-
Drücken Sie Speichern.
Sie können Ihren Inhalten einen Link zu einer E-Mail-Adresse hinzufügen. Wenn der Leser den Link anklickt, wird seine Standard-E-Mail-Anwendung geöffnet und eine neue E-Mail erstellt, wobei die verknüpfte E-Mail-Adresse im Feld An: steht.
-
Wählen Sie das Topic oder die Komponente im Content Manager aus, um es/sie im Editor zu öffnen.
-
Geben Sie die E-Mail-Adresse oder einen anderen Text ein, der als E-Mail-Link dienen soll.
-
Markieren Sie den Text.
-
Wählen Sie die Registerkarte Einfügen im Symbolleiste.
-
Wählen Sie Link und dann E-Mail-Adresse.
-
Geben Sie die E-Mail-Adresse ein, die dem Feld To: in einer neuen E-Mail hinzugefügt wird.
-
Das Etikett zeigt den von Ihnen eingegebenen und hervorgehobenen Linktext in Ihrem Topic an.
Sie können es bei Bedarf im Feld Etikett bearbeiten.
-
Wählen Sie Einfügen, um den Link hinzuzufügen.
-
Drücken Sie Speichern.
Wenn Sie Schritt-für-Schritt-Verfahren und nummerierte Listen erstellen, müssen Sie möglicherweise auf einen anderen Schritt oder ein Listenelement verweisen. Für diese Verweise ist es oft besser, den Link als Schritt- oder Listenelementnummer erscheinen zu lassen und dies automatisch zu verwalten. Wenn sich dann die Reihenfolge der Schritte oder Listenelemente ändert, aktualisiert Paligo den Verweis automatisch, um die entsprechende Nummer zu verwenden.
Wählen Sie das Kästchen Auto für den Querverweis aus, damit er so aussieht (wobei n die Zahl ist):
-
Schritt n für Schritte in einem Verfahren.
-
n für Listenelemente in einer nummerierten Liste.
Um auf ein Listenelement oder einen Verfahrensschritt innerhalb eines Topics zu verweisen, siehe Querverweis innerhalb des Topics hinzufügen.
Um auf ein Listenelement oder einen Verfahrensschritt in einem anderen Topic zu verweisen, müssen Sie sicherstellen, dass dieser Schritt oder Listenelement eine xml:id
hat und Sie diese xml:id
in Ihrem Querverweis verwenden.
Um ein Listenelement oder Verfahrensschritt in einem anderen Topic zu verlinken:
-
Öffnen Sie das Topic, das das Listenelement oder den Verfahrensschritt enthält, zu dem Sie verlinken möchten.
-
Positionieren Sie den Cursor auf dem Listenelement oder dem Schritt, zu dem Sie verlinken möchten.
-
Wählen Sie das Element
listitem
oder das Elementstep
im Menü „Elementstruktur“ und wählen Sie anschließend Zum Element gehen aus. -
Prüfen Sie, ob eine
xml:id
im Panel „Elementattribute“ hinzugefügt wurde:-
Wenn bereits eine
xml:id
hinzugefügt wurde, überspringen Sie den nächsten Schritt. -
Wenn es keine
xml:id
gibt, müssen Sie sie hinzufügen. Fahren Sie mit dem nächsten Schritt fort.
-
-
Wählen Sie das Element
listitem
oder das Elementstep
im Menü „Elementstruktur“ und wählen Sie anschließend ID generieren aus.Paligo generiert automatisch ein Attribut xml:id für das Listenelement oder den Schritt.
-
Kopieren Sie den Wert
xml:id
für das Listenelement oder Schrittelement in das Panel „Elementattribute“. Sie benötigen dies für den Querverweis. -
Öffnen Sie das Topic, das den Querverweis enthalten soll.
-
Positionieren Sie den Cursor dort, wo der Link eingefügt werden soll.
Tipp
Alternativ können Sie Text markieren, der als Linkbezeichnung fungieren soll.
-
Wählen Sie die Registerkarte Einfügen im Symbolleiste.
-
Wählen Sie Link und danach Querverweis.
Tipp
Oder verwenden Sie die Tastenkombination Alt + R (Windows) oder Option ⌥ + R (Mac), um den Querverweis hinzuzufügen.
-
Fügen Sie einen Querverweis zum Topic hinzu, das das Listenelement oder den Verfahrensschritt enthält, auf den Sie verweisen möchten.
-
Wählen Sie den Querverweis im Menü „Elementstruktur“ aus und wählen Sie Zum Element gehen.
-
Im Panel „Elementattribute“ hat der Querverweis ein Attribut
xlink:href
und der Wert des Attributs ist ein Verweis auf das Zielthema. -
Fügen Sie einen Schrägstrich / am Ende des Attributwerts
xlink:href
hinzu und fügen Sie dann die ID ein, die Sie in Schritt 6 kopiert haben.Zum Beispiel: urn:resource:component:28836/step-idm73263043573356
Dabei ist der Text vor dem Schrägstrich der Verweis auf das Topic und der Text nach dem Schrägstrich die ID für den Schritt.
-
Drücken Sie Speichern.
Beim Verfassen Ihrer Topics in Paligo können Sie Links zu externen Dateien hinzufügen, die lokal statt im Internet gespeichert werden. Beispielsweise möchten Sie eine Verknüpfung zu einer PDF-Datei herstellen, die Sie in einem Ordner speichern, der nach der Veröffentlichung zu Ihren Ausgabedateien hinzugefügt wird.
Um einen Link zu einer lokalen Datei zu erstellen, verwenden Sie die Link-Funktion der externen Website und bearbeiten Sie den Link:
-
Wählen Sie das Topic oder die Komponente im Content Manager aus, um es/sie im Editor zu öffnen.
-
Positionieren Sie den Cursor dort, wo der Link eingefügt werden soll.
Tipp
Alternativ können Sie Text markieren, der als Linkbezeichnung fungieren soll.
-
Wählen Sie die Registerkarte Einfügen im Symbolleiste.
-
Wählen Sie Link und dann Externer Link.
-
Geben Sie eine Linkbezeichnung und ein Linkziel ein.
Lassen Sie das Feld Linkbezeichnung leer, um die URL anzuzeigen.
Anmerkung
Wenn Sie einen relativen Link verwenden möchten, aktivieren Sie die Option Kurze und flache URL-Struktur für Ausgabedateien verwenden in den Einstellungen Ihres Layouts. Damit wird eine Ausgabe mit flacher Struktur generiert, in der sich alle HTML-Dateien in einem Ordner befinden.
-
Wählen Sie Einfügen aus.
-
Entfernen Sie das Präfix
http://
, um statt mit einer Webadresse im Panel „Elementattribute“ mit einer lokalen Datei zu verlinken.Paligo fügt dem im vorherigen Schritt eingegebenen
xlink:href
-Attribut automatisch das Präfixhttp://
hinzu. -
Drücken Sie Speichern.
-
Veröffentlichen Sie das Topic.
-
Fügen Sie nach der Veröffentlichung die lokalen Dateien (z. B. PDF) zu dem Speicherort hinzu, den Sie als Linkziel definiert haben.
Sie können einen externen Link verwenden, um den Benutzer zu einer Telefon-App weiterzuleiten, in die die Nummer automatisch eingegeben wird. Dies geschieht in zwei Schritten:
-
Skript hinzufügen zu Telefonnummer weiterleiten
Wichtig
Wenn das HTML5-Layout bereits eine benutzerdefinierte JavaScript-Datei verwendet, sollten Sie Ihre Änderungen zu dieser Datei hinzufügen, anstatt eine neue zu erstellen.
Wenn Sie eine neue JavaScript-Datei hochladen, wird die vorhandene ersetzt und Sie verlieren die Funktionalität der alten JavaScript-Datei.
Ein Telefonnummern-Link ist ein externer Link, dessen Attribut role
auf tel
gesetzt wird. Um es an eine Telefon-App weiterzuleiten, benötigen Sie ein Skript zum Abrufen, siehe Telefonnummer weiterleiten.
So fügen Sie einen Telefonnummern-Link zu einem Topic hinzu:
-
Wählen Sie das Topic oder die Komponente im Content Manager aus, um es/sie im Editor zu öffnen.
-
Positionieren Sie den Cursor dort, wo der Link eingefügt werden soll.
Tipp
Alternativ können Sie Text markieren, der als Linkbezeichnung fungieren soll.
-
Wählen Sie die Registerkarte Einfügen im Symbolleiste.
-
Wählen Sie Link und dann Externer Link.
-
Fügen Sie eine Linkbeschriftung hinzu und verwenden Sie die Telefonnummer als Link-Ziel.
-
Wählen Sie Einfügen aus.
-
Wählen Sie den
Link
im Menü „Elementstruktur“ aus und wählen Sie Zum Element gehen. -
Entfernen Sie http:// vor der Telefonnummer im Panel „Elementattribute“.
-
Fügen Sie das Attribut
role
im Panel „Elementattribute“ hinzu und setzen Sie seinen Wert auftel
. -
Drücken Sie Speichern.
So fügen Sie ein Skript hinzu, das den Benutzer zu einer Telefon-App mit der automatisch eingegebenen Nummer weiterleitet:
-
Verwenden Sie zum Erstellen (oder Aktualisieren) der JavaScript-Datei einen Text- oder Code-Editor.
-
Fügen Sie das folgende Skript hinzu:
$(document).ready(function () { for (const phoneLink of document.getElementsByClassName("link tel")) { phoneLink.href = `tel:${phoneLink.getAttribute('href')}` } });
-
Speichern Sie Ihre JavaScript-Datei und stellen Sie sicher, dass sie die Dateierweiterung
.js
hat.
Bei Querverweisen können Sie Ihren eigenen Text (als Etikett bezeichnet) eingeben. Für manche Elemente kann auch die Autotext-Funktion von Paligo verwendet werden. Der automatische Text, den Paligo hinzufügt, variiert je nach Typ des Elements, auf das Sie verweisen.
Wenn Sie auf eines der folgenden Elemente verweisen, wird für den automatischen Text der Text aus dem Titel
des Elements verwendet:
-
table
-
equation
-
example
-
procedure
-
figure
Sollten diese Elemente kein title
-Element haben, geben Sie eigenen Text ein und verwenden Sie nicht die automatische Textfunktion für den Querverweis.
Für die meisten anderen Elemente verwendet der automatische Text den Titel
des übergeordneten Abschnitts. Wenn Sie beispielsweise einen Querverweis auf einen Absatz in einem Topic erstellen, verwendet der Autotext den Titel
des Topics.
Wenn Sie auf einen Schritt
in einem Verfahren querverweisen, erscheint der automatische Text als "Step n", wobei n die Nummer ist. Wir empfehlen, auch einen Querverweis zum Titel
des Ziel-Topics hinzuzufügen, damit der Nutzer besser nachvollziehen kann, wo der Schritt sich befindet.
Anmerkung
Der im Paligo Editor angezeigte Text entspricht nicht unbedingt dem, was Sie in der veröffentlichten Ausgabe sehen werden. Beispielsweise erscheinen Querverweise auf einen Schritt in einer Prozedur als Link zum Ziel-Topic im Editor, werden aber im Rahmen des Veröffentlichungsprozesses in „Schritt n “ umgewandelt.
Um den Text für einen Querverweis zu ändern, wählen Sie ihn aus, woraufhin der Querverweis-Editor angezeigt wird. Dort können Sie die Bezeichnung im Feld bearbeiten und das Kontrollkästchen Auto verwenden, um automatischen Text zu aktivieren oder zu deaktivieren. Sie können das Etikett nur dann bearbeiten, wenn Auto deaktiviert ist.
Tipp
Sie können den automatisch generierten Text für Querverweise und Links anpassen, siehe Gestalten von Querverweisen.
Sie können Paligo so einstellen, dass automatische Links zu anderen verwandten Topics erstellt werden. Die Links erscheinen am Ende eines Topics und unterstützen den Leser bei seiner Suche nach weiteren relevanten Informationen. Automatische Links lassen sich übrigens viel einfacher und schneller einrichten und verwalten als manuell eingegebene Links.
Es gibt zwei Arten von automatischen Links:
-
Auf dem Inhaltsverzeichnis basierende automatische Links erscheinen unter der Überschrift „In diesem Abschnitt“. Hierbei handelt es sich um Links zu Topics, die dem Topic untergeordnet sind, siehe Aktivieren des Abschnitts-Inhaltsverzeichnisses.
-
Mit Taxonomiebasierten automatischen Links lassen sich die Beziehungen zwischen Topics steuern. Standardmäßig erscheinen diese Links unter einer Überschrift „Siehe auch“.
Sie können Taxonomie-Tags verwenden, um Paligo anzuweisen, automatische Verweise zwischen Topics zu erstellen. Die Verweise erscheinen gesammelt unter „Siehe auch“ am Ende eines Topics.
Anmerkung
Taxonomie-Tags lassen sich auch für weitere Zwecke einsetzen. Weitere Informationen finden Sie unter Taxonomien.
So richten Sie taxonomiebasierte „Siehe auch“-Verweise ein:
-
Richten Sie das/die Layout(s) ein, um die „Siehe auch“-Verweise zu aktivieren:
-
Verwenden Sie das/die Layout(s), das/die Sie in Schritt 2 bearbeitet haben, um Ihre Inhalte zu veröffentlichen.
In einem Video zeigen wir, wie „Siehe auch“-Verweise für eine HTML5-Helpcenter-Ausgabe eingerichtet werden (siehe Beispiel für „Siehe auch“-Links in einem HTML5-Helpcenter).
Die erste Aufgabe besteht darin, die Taxonomien für Ihre „Siehe auch“-Verweise einzurichten.
-
Wählen Sie den Taxonomie-Manager im Content Manager aus, um die Struktur zu öffnen.
-
Wählen Sie das Drei-Punkte-Menü (...) für die Taxonomien und wählen Sie Taxonomie-Tag erstellen.
-
Geben Sie Ihrem übergeordneten Taxonomie-Tag einen Namen.
Dieses wird als übergeordnetes Taxonomie-Tag fungieren (auch „Parent“ genannt). Wir empfehlen Ihnen, dieses Tag mit Siehe auch“-Verweise zu benennen, Sie können aber auch eine beliebige andere Bezeichnung wählen.
-
Wählen Sie das Drei-Punkte-Menü (...) für das neue übergeordnete Taxonomie-Tag und dann Taxonomie-Tag erstellen.
Paligo erstellt ein Taxonomie-Tag auf einer niedrigeren Ebene. Dieser ist ein untergeordnetes Tag (auch „Child“ genannt) zu Ihrem übergeordneten Tag („Parent“).
-
Geben Sie Ihrem untergeordneten Taxonomie-Tag einen Namen.
Dieses untergeordnete Tag werden Sie zur Zuordnung verwandter Topics verwenden, wählen Sie also eine Benennung, der sie als Gesamtheit repräsentiert. Wenn es beispielsweise bei allen Topics um das Laden oder den Austausch eines Telefonakkus geht, können Sie das Tag „Akku“ nennen.
-
Erstellen Sie so viele untergeordnete Taxonomie-Tags wie Sie benötigen.
Sie haben nun ein „Parent“-Tag und ein oder mehrere „Child“-Tags.
-
Wählen Sie das Drei-Punkte-Menü (...) für das „Parent“-Tag und wählen hier Floating Panel aus.
Paligo zeigt nun das Floating Panel für die Taxonomien an.
-
Ziehen Sie Ihre untergeordneten Taxonomie-Tags aus dem Floating Panel auf die relevanten Topics im Content Manager.
Anmerkung
Ziehen Sie das übergeordnete Tag nicht auf ein Topic, da die „Siehe auch“-Links sonst nicht mehr funktionieren.
Anmerkung
Mit einem Doppelklick auf ein Taxonomie-Tag erfahren Sie, welche Topics mit einer Taxonomie verbunden sind. Paligo zeigt Details zu diesem Taxonomie-Tag an, einschließlich der Namen der Topics, die es verwenden.
Nachdem die Taxonomien eingerichtet und mit Ihren Topics verknüpft sind, besteht der nächste Schritt darin, Ihr Layout einzurichten:
Wenn Sie Ihre Inhalte in einem HTML5-Helpcenter veröffentlichen möchten, richten Sie Ihr Layout für „Siehe auch“-Links ein:
-
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 auf der Seitenleiste Klassen und Attribute aus.
-
Wählen Sie Aktivieren für Ausgabe-Taxonomien.
-
Geben Sie den Namen des übergeordneten Taxonomie-Tags, gefolgt von einem Semikolon, in der Beziehungs-Taxonomie ein.
-
Wählen Sie Aktivieren für Ausgabe von role-Attributen als Klassennamen.
-
Wählen Sie in der Seitenleiste Inhaltsverzeichnis und Chunking aus.
-
Vergewissern Sie sich, ob Abschnitts-Inhaltsverzeichnis verwenden entweder auf Standard, Vorher oder Nachher eingestellt ist.
-
Drücken Sie Speichern.
-
Veröffentlichen Sie Ihre Inhalte mit dem von Ihnen bearbeiteten Layout. Paligo erstellt die „Siehe auch“-Links automatisch und fügt sie am Ende der jeweiligen Topics ein.
Wenn Sie Ihre Inhalte in PDF veröffentlichen möchten, richten Sie Ihr PDF-Layout so ein, dass die Abschnitte „Siehe auch“ unterstützt werden:
-
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.
-
Erweitern Sie die Kategorie Allgemein und wählen Sie Filtern und Taxonomien.
-
Legen Sie Ausgabe-Taxonomien auf Aktivieren fest.
-
Geben Sie im Abschnitt Beziehungstaxonomie den Namen Ihres „übergeordneten“ Taxonomie-Tags für „Siehe auch“-Tags ein. Wenn Sie beispielsweise dem „übergeordneten“ Tag den Namen „„Siehe auch“-Links“ gegeben haben, sollten Sie „„Siehe auch“-Links“ in das Feld Beziehungs-Taxonomie eingeben.
-
Wählen Sie den Abschnitt Beziehungs-Topics und gestatlen Sie mit den dortigen Einstellungen die „Siehe auch“-Abschnitte und -Links (optional).
-
Drücken Sie Speichern.
-
Veröffentlichen Sie Ihre Inhalte mit dem von Ihnen bearbeiteten Layout. Paligo erstellt die „Siehe auch“-Links automatisch und fügt sie am Ende der jeweiligen Topics ein.
Das folgende Video zeigt, wie „Siehe auch“-Links für eine HTML5-Helpcenter-Ausgabe eingerichtet werden. Falls Sie das Video nicht ansehen können, führen Sie die in Taxonomien für „Siehe auch“-Verweise einrichten und Das HTML5-Helpcenter-Layout für „Siehe auch“-Links einrichten beschriebenen Schritte aus.
Standardmäßig werden externe Links in HTML/HTML5-Ausgaben in einem neuen Browserfenster geöffnet. Um das Standardverhalten für alle externen Links zu ändern, müssen die Layouteinstellungen aktualisiert werden. Dafür gibt es vier Möglichkeiten:
-
_blank – Öffnet den Link in einem neuen Browserfenster. Standardeinstellung
-
_self – Öffnet den Link im selben Browserfenster.
-
_parent – Wenn der Link in anderen Frames (Rahmen) eingebettet ist, öffnet er den nächstgelegenen Frame (eine Ebene höher) im Browserfenster.
-
_top – Wenn der Link in anderen Frames eingebettet ist, öffnet er die ursprüngliche Webseite (den obersten/äußersten Frame) im Browserfenster.
Nachfolgend wird beschrieben, wie Sie das Standard-Linkverhalten für externe Links ändern können, die im selben Browserfenster geöffnet werden sollen.
-
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 Querverweise aus.
-
Scrollen Sie nach unten zum Abschnitt Links zu externen Websites in neuem Tab oder neuem Fenster öffnen.
-
Wählen Sie _self aus dem Menü.
-
Drücken Sie Speichern.
Über Einfügen > Link > Querverweis können Sie einen Querverweis zu einem bestimmten Element in einem anderen Topic hinzufügen. Dies ist jedoch nur möglich, wenn das Element, zu dem verlinkt wird, eine XML-ID hat. Besitzt es keine XML-ID, müssen Sie das Ziel-Topic bearbeiten und dem Element eine XML-ID zuweisen.
Tipp
Wir empfehlen, Querverweise zwischen Topics nur dort zu verwenden, wo es notwendig ist, um Abhängigkeiten zu vermeiden. Querverweise funktionieren nur, wenn in der Publikation sowohl das Quellen-Topic (das den Querverweis enthält) als auch das Ziel-Topic enthalten sind. Daher kann die Verwendung von Querverweisen zwischen Topics sich auf die Wiederverwendbarkeit Ihrer Topics auswirken.
So fügen Sie einen Querverweis zu einem Element in einem anderen Topic hinzu:
-
Öffnen Sie das Topic, das das Element enthält, zu dem Sie verlinken möchten.
-
Positionieren Sie den Cursor auf das Element, zu dem Sie verlinken möchten.
-
Wählen Sie das Element im Menü „Elementstruktur“ und wählen Sie Zum Element gehen aus.
-
Prüfen Sie, ob eine
xml:id
im Panel „Elementattribute“ hinzugefügt wurde:-
Wenn bereits eine
xml:id
hinzugefügt wurde, überspringen Sie den nächsten Schritt. -
Wenn es keine
xml:id
gibt, müssen Sie sie hinzufügen. Fahren Sie mit dem nächsten Schritt fort.
-
-
Wählen Sie das Element im Menü „Elementstruktur“ und wählen Sie ID generieren aus.
Paligo generiert automatisch ein Attribut xml:id für das Listenelement oder den Schritt.
-
Drücken Sie Speichern.
-
Öffnen Sie das Topic, das den Querverweis enthalten soll.
-
Positionieren Sie den Cursor dort, wo der Link eingefügt werden soll.
Tipp
Alternativ können Sie Text markieren, der als Linkbezeichnung fungieren soll.
-
Wählen Sie die Registerkarte Einfügen im Symbolleiste.
-
Wählen Sie Link und danach Querverweis.
Tipp
Oder verwenden Sie die Tastenkombination Alt + R (Windows) oder Option ⌥ + R (Mac), um den Querverweis hinzuzufügen.
-
Geben Sie einen Text als Linkbezeichnung ein. Lassen Sie das Feld leer, wenn der Linktext mit dem Topic-Titel übereinstimmen soll, siehe Auto-Text für Querverweise.
-
Wählen Sie, ob der Querverweis auf das topic oder eine fork erfolgen soll.
Wählen Sie den Pfeil neben dem Topic, um es zu erweitern und seine Elemente anzuzeigen.
-
Wählen Sie das Element aus, das den Querverweis erhalten soll.
Anmerkung
Querverweise auf
listitem
-Elemente innerhalb von Aufzählungen und geordneten Listen (nummerierte Listen) können zu ungewöhnlichen Resultaten führen oder sogar ganz aus von Ihrer veröffentlichten Ausgabe ausgeschlossen werden. Für diese empfehlen wir Ihnen, stattdessen auf ein Titelelement zu verweisen und zu erläutern, auf welchen Schritt sich der Verweis bezieht.Paligo unterstützt Querverweise auf Schritte in Verfahren, und diese werden in der veröffentlichten Ausgabe als „Schritt n“ aufgeführt. Damit Ihre Leser mehr Kontext haben, empfiehlt es sich, dem Querverweis zum Titel des Ziel-Topics auch etwas Text hinzuzufügen. Beispielsweise „Siehe Schritt 4 unter Installation der Batterie“, wobei „Schritt 4“ ein Querverweis auf den Schritt und „Installation der Batterie“ ein Querverweis auf den Titel des Ziel-Topics ist.
Paligo fügt den Querverweis zu Ihrem Topic hinzu.
Anmerkung
Querverweise auf Verfahrensschritte werden im Editor nicht als „Schritt n“ angezeigt. Der Link zum Ziel-Topic und -Element wird beim Veröffentlichen in „Schritt n“ umgewandelt.
-
Drücken Sie Speichern.
Tipp
Wenn Sie den Querverweistext ändern oder automatischen Text verwenden möchten, wählen Sie diesen aus, um den Querverweis-Editor anzuzeigen. Verwenden Sie ihn, um automatischen Text zu aktivieren oder zu deaktivieren und den Text der Beschriftung zu ändern, siehe auch Auto-Text für Querverweise.
Nachdem Sie den Link eingefügt haben, steht eine Popup-Symbolleiste zur Verfügung, in der Sie den Link bearbeiten können, wenn er ausgewählt ist.
Ist das Kontrollkästchen auto
-
Markiert (Standardeinstellung), dann erhält der Link automatisch den Titel des Ziel-Topics als Linktext.
-
Nicht markiert, geben Sie statt des Topic-Titels den gewünschten Text direkt in den Link ein.
Tipp
Sie können den automatisch generierten Text für Querverweise und Links anpassen, siehe Gestalten von Querverweisen.
So bearbeiten Sie das Linkziel:
-
Wählen Sie den blauen Stift rechts, um den Content Manager-Browser zu öffnen.
Daraufhin wird das aktuell ausgewählte Ziel angezeigt.
-
Wählen Sie im Browser ein anderes Linkziel aus.
Tipp
Wenn Sie zum Ziel-Topic gelangen möchten, klicken Sie einfach auf das Symbol links.
-
Drücken Sie Speichern.
Sie können ein Google Doc- oder OneDrive-Dokument einbetten, indem Sie einen speziellen Linktyp verwenden. Vorher müssen Sie Ihr Dokument für das Einbetten verfügbar machen.
-
Die Vorgehensweise variiert je nach Dokumenttyp:
-
Für Google Docs wählen Sie Datei > Im Internet veröffentlichen in Ihrem Google Doc aus. Kopieren Sie anschließend die Link-URL.
-
Für Google Slides wählen Sie Datei > Im Internet veröffentlichen in Ihren Google Slides. Danach kopieren Sie den Link Einbetten. Sie müssen diesen Link bearbeiten, bevor Sie ihn in Schritt 4 verwenden können. Beim Bearbeiten entfernen Sie die Frame-Informationen. Nehmen wir zum Beispiel an, Ihr eingebetteter Link sieht so aus:
<iframe src="https://docs.google.com/presentation/d/e/long_string_of_characters/embed?start=false&loop=false&delayms=3000" frameborder="0" width="960" height="569" allowfullscreen="true" mozallowfullscreen="true" webkitallowfullscreen="true"></iframe>
Entfernen Sie das am Anfang stehende
<iframe src="
sowie alles, was nach /embed folgt, damit der Link so aussieht:https://docs.google.com/presentation/d/e/long_string_of_characters/embed
-
Für OneDrive:
-
Wählen Sie die Datei aus, die Sie einbetten möchten, indem Sie das Kontrollkästchen in der oberen rechten Ecke der Datei markieren.
-
Wählen Sie Einbetten oben auf der Seite und dann Generieren.
Anmerkung
Diese Funktion eignet sich nur für Dokumente und kann nicht für Bilder verwendet werden.
-
-
-
Fügen Sie ein
link
-Element an der Stelle im Topic ein, wo Sie das Dokument einbetten möchten. Es muss in einempara
stehen, wobei der Absatz nur diesen einen Link enthalten sollte.Tipp
Wenn Sie einen Linktext hinzufügen, sehen Sie leichter, wo er hinführt, allerdings wird dieser Text nicht in der Ausgabe verwendet.
-
Fügen Sie ein
role
-Attribut hinzu. Für Google Docs stellen Sie den Wertgdoc
und für ein OneDrive-Dokumentonedrive
ein. -
Fügen Sie ein
xlink:href
-Attribut hinzu und setzen Sie als Wert die eingebettete URL ein.
Anmerkung
-
Das Dokument wird nicht in das Topic im Editor eingebettet, sondern es zeigt nur an, dass es ein eingebettetes Topic gibt. Das Einbetten selbst erfolgt bei der Veröffentlichung.
-
Die Einbettungsfunktion ist nur für HTML5- oder Zendesk-Ausgaben verfügbar. Für andere Formate wird ein normaler Link erstellt.
Wenn Sie das role
-Attribut zu einem externen Link hinzufügen und den Wert auf external
setzen, erscheint die Webseite in Ihrer Ausgabe wie unten dargestellt als iframe
-Element.
Anmerkung
Paligo kann externe Links nicht validieren, daher müssen Sie sie ihre Funktion testen.
So fügen Sie einen externen Link ein:
-
Wählen Sie das Topic oder die Komponente im Content Manager aus, um es/sie im Editor zu öffnen.
-
Positionieren Sie den Cursor innerhalb eines Absatzes.
-
Wählen Sie die Registerkarte Einfügen im Symbolleiste.
-
Wählen Sie Link und dann Externer Link.
-
Geben Sie eine Linkbezeichnung und ein Linkziel ein.
Lassen Sie das Feld Linkbezeichnung leer, um die URL anzuzeigen.
-
Wählen Sie Einfügen aus.
-
Wählen Sie das
link
-Element im Menü „Elementstruktur“ aus und wählen Sie Zum Element gehen. -
Fügen Sie im Panel „Elementattribute“ das
role
-Attribut hinzu und setzen Sie den Wert aufexternal
. -
Fügen Sie das Attribut
xlink:href
hinzu und geben Sie die URL als Wert ein. -
Drücken Sie Speichern.
-
Wählen Sie im Symbolleiste die Registerkarte Vorschau.
-
Veröffentlichen Sie in HTML5, um zu testen, ob die eingebettete Seite funktioniert.
Paligo-Inhalte werden in einer Datenbank gespeichert, wobei jedes Element eine eigene eindeutige ID haben kann. Bestimmte Arten von Inhalten wie Absätze, Bilder oder Variablen haben einen speziellen Typ von ID namens xinfo
, der stets von Paligo generiert wird. Andere Elemente können
eine optionale ID namens xml:ID
haben, die entweder automatisch von Paligo oder manuell von Ihnen generiert werden kann.
Querverweise in Paligo entnehmen das Ziel des Querverweises aus der ID. Für manche Typen von Querverweisen erstellt Paligo die ID automatisch, vor allem für Komponenten, die einen Titel haben können. Dieser wird als xml:id
-Attribut hinzugefügt. Dennoch müssen Sie möglicherweise ein
xml:id
-Attribut manuell hinzufügen, um Querverweise auf andere Inhaltstypen zu erstellen. Dies gilt sowohl für Querverweise zwischen Topics als auch für Querverweise auf Inhalte innerhalb ein und desselben Topics, z. B. zu einem Unterabschnitt.
In der Regel sind Querverweise auf folgende Elemente zu empfehlen:
-
Abschnitt
-
Unterabschnitt – ein
Abschnitt
innerhalb eines anderenAbschnitts
-
Eine Struktur, die einen
Titel
haben kann, z. B. eineTabelle
.
Anmerkung
Wenn Sie auf einen anderen Inhaltstyp verweisen möchten, ist dies nur möglich, wenn der betreffende Inhalt eine xml:id
hat. Möglicherweise müssen Sie zunächst IDs für Querverweise manuell generieren, bevor Sie eine Verknüpfung herstellen können.
Paligo lässt sich auch so einstellen, dass xml:ids
automatisch generiert werden, siehe IDs für Querverweise automatisch generieren .
Sie können nur Querverweise zu Elementen hinzufügen, die eine xml:id
haben. Wenn das Element, auf das Sie verweisen möchten, keine xml:id hat, können Sie diese manuell generieren. Paligo hat eine Funktion im Editor, die eine passende ID generiert. Es ist nicht ratsam, eigene
ID-Werte zu erstellen, da IDs eindeutig sein sollten.
Tipp
Sie können Paligo so einstellen, dass die xml:ids
automatisch generiert werden, siehe IDs für Querverweise automatisch generieren.
So generieren Sie eine eindeutige xml:id
für ein Element:
-
Wählen Sie das Topic oder die Komponente im Content Manager aus, um es/sie im Editor zu öffnen.
-
Wählen Sie das Zielelement in Menü „Elementstruktur“ und wählen Sie dann ID generieren.
Wenn Sie beispielsweise einen Link zu einem Verfahren erstellen möchten, wählen Sie das
procedure
-Element aus.Paligo erzeugt eine
xml:id
für das Element im Panel „Elementattribute“ -
Drücken Sie Speichern.
Anmerkung
Jetzt sollten Sie einen Querverweis zum Element hinzufügen können, siehe:
Beim Speichern eines Topics kann Paligo automatisch generierte IDs an neue Elemente vergeben. Diese Funktion ist sehr nützlich, denn IDs werden für Querverweise benötigt. Dadurch ersparen Sie sich Mühe und Zeit für ein manuelles Hinzufügen von xml:ids
.
Mithilfe der Editoreinstellungen können Sie steuern, welche Elementtypen automatisch generierte IDs erhalten sollen. Die von Ihnen gewählten Einstellungen gelten für alle Topics und sämtliche Benutzer Ihrer Paligo-Instanz. In der Regel ist für die meisten Benutzer die automatische Generierung von xml:ids
für die folgenden Elemente ausreichend (bei Bedarf können Sie weitere Elemente zur Liste hinzufügen):
-
Wählen Sie das Topic oder die Komponente im Content Manager aus, um es/sie im Editor zu öffnen.
-
Wählen Sie das cog-Symbol im Symbolleiste aus.
-
Wählen Sie die Registerkarte Globale Einstellungen im Editor-Einstellungen.
-
Fügen Sie im Feld Autogenerierte ID die Namen der Elemente hinzu, die automatisch generierte
xml:ids
erhalten sollen.In der Regel ist für die meisten Benutzer die automatische Generierung von
xml:ids
für die folgenden Elemente ausreichend (bei Bedarf können Sie weitere Elemente zur Liste hinzufügen):section figure table example equation procedure bridgehead sidebar note warning caution tip important
Verwenden Sie Leerzeichen, um die einzelnen Elementnamen voneinander zu trennen, und achten Sie darauf, Elementnamen in Kleinbuchstaben zu schreiben.
Anmerkung
Wir empfehlen, keine der Standardelemente zu entfernen und nur bei Bedarf welche hinzuzufügen. In vielen Fällen reicht die Verlinkung auf ein
section
-Element aus, um den Leser zu den relevanten Informationen zu führen.Achtung
Wenn Sie die Standardeinstellungen ändern, bei denen Elementen automatisch eine ID zugewiesen wird, empfehlen wir Ihnen, nur die größeren Blockelementstrukturen einzubeziehen.
Elemente wie
para
undtitle
sollten nicht eingeschlossen werden, da dies Probleme mit duplizierten IDs verursachen kann, wenn Sie Textfragmente wiederverwenden. -
Wählen SieEinstellungen speichern aus.
Wenn Sie oder andere Benutzer ein neues Element zu einem Topic hinzufügen, prüft Paligo, ob es im Feld Automatisch generierte ID aufgeführt ist. Wenn es aufgelistet ist, gibt Paligo diesem Element eine xml:id
. Es werden jedoch nur neue Elemente
mit einer xml:id
versehen, keine Elemente, die zuvor im Topic vorhanden waren.
Tipp
Es ist auch möglich, xml:ids
über Menü „Elementstruktur“ manuell zu generieren, siehe IDs für Querverweise manuell generieren
Wenn ein Element in einer Publikation mehrfach verwendet wird und Sie auf das Element in einem bestimmten Topic verlinken möchten, um dem Leser den richtigen Kontext zu geben, müssen Sie für Ihre PDF-Ausgabe Gabelungslinks
manuell
erstellen.
Sie können Querverweise zu Über Elemente (Bilder, Absätze, Verfahren, Tabellen) hinzufügen, die in Komponenten oder Topics wiederverwendet werden, sie verweisen jedoch an die Stelle, an der das Element ursprünglich erstellt wurde, siehe Querverweise und Links.
Wird ein Topic oder eine Komponente in eine Publikation aufgenommen, erhält es eine eindeutige fork:id
für diese bestimmte Instanz in der Publikation. Wenn Sie das Element xml:id
zur fork:id
hinzufügen, erhalten
Sie einen Gabelungslink,
der auf das Element in der wiederverwendeten Position verweist. In der PDF-Ausgabe zeigt der Gabelungslink standardmäßig die Seitenzahl in eckigen Klammern an. Zum Gestalten des Querverweises siehe Gestalten von Querverweisen.
Anmerkung
Ein manuell erstellter Gabelungslink
funktioniert nur in der Publikation, aus der er ursprünglich stammt.
So erstellen Sie manuell einen Gabelungslink:
-
Generieren Sie eine
xml:id
für das Zielelement, siehe IDs für Querverweise manuell generieren. -
Öffnen Sie das Topic, in dem sich der Querverweis befindet.
-
Wählen Sie Link und danach in der Symbolleiste Querverweis.
-
Geben Sie eine Linkbezeichnung ein. (Das ist optional).
-
Navigieren Sie zur Publikation.
Anmerkung
Der Querverweis-Dialog zeigt die Ziele sowohl als Teil der Publikation als auch als Topic (außerhalb des Publikationsbaums) an. Es ist wichtig, das Ziel innerhalb des Publikationsbaum auszuwählen, um den
Gabelungs-Link
zu erhalten!Erfahren Sie mehr über den Unterschied zwischen Topics und Gabelungen unter Topic oder Gabelung.
-
Um verlinkbare Elemente anzuzeigen, klicken Sie auf den Pfeil vor dem Topic.
-
Wählen Sie das Element aus, damit es im Topic als Link angezeigt wird. Dieser führt direkt zum ursprünglichen Element.
-
Kopieren Sie das Element
xml:id
(vom vorderen Schrägstrich „ / “ und weiter) aus dem erstellten Link. -
Leiten Sie den Querverweis auf das Topic mit der wiederverwendeten Komponente um.
In unserem Beispiel ist es „Batterieentsorgung“.
Anmerkung
Der Querverweis-Dialog zeigt die Ziele sowohl als Teil der Publikation als auch als Topic (außerhalb des Publikationsbaums) an. Es ist wichtig, das Ziel innerhalb des Publikationsbaum auszuwählen, um den
Gabelungs-Link
zu erhalten!Erfahren Sie mehr über den Unterschied zwischen Topics und Gabelungen unter Topic oder Gabelung.
-
Fügen Sie im Panel „Elementattribute“ das Element
xml:id
nach derfork:id
des Topics ein.In unserem Beispiel lautet die
fork:id
für die Batterieentsorgung "urn:resource:fork:37742". -
Drücken Sie Speichern.
-
Veröffentlichen Sie das Topic als PDF, um den Link zu testen.
In der Vorschau können keine
Gabelungslinks
angezeigt werden.
Es kann vorkommen, dass Sie ein reguläres Topic bearbeiten und Informationen hinzufügen möchten, die in einem Publikations-Topic gespeichert sind. Sie können beispielsweise das Urheberrechtsjahr und den Inhaber zu einem Topic hinzufügen.
Eine Möglichkeit hierfür ist die Verwendung einer dynamischen Variablen. Diese fungiert als Verweis auf ein anderes Element.
-
Bearbeiten Sie Ihr reguläres Topic.
Anmerkung
Das Topic muss in mindestens einer Publikation enthalten sein. Bei der Veröffentlichung übernimmt Paligo die Informationen aus dem Topic der Publikation und fügt sie in die dynamische Variable ein.
-
Verwenden Sie zum Hinzufügen einer dynamischen Variablen ein Tastaturkürzel.
Das Kürzel lautet:
-
Windows: Strg + Alt + Umschalt + I
-
Mac: Control ^ + Option ⌥ + Umschalt ⇧ + I
Alternativ können Sie ein phrase-Element hinzufügen und diesem das role-Attribut mit dem Wert
dyntextvar
zuweisen.Weitere Informationen finden Sie unter Eine dynamische Textvariable einfügen.
-
-
Erstellen Sie den Verweis in der dynamischen Textvariablen. Für einen Verweis auf das Publikations-Topic verwenden Sie folgende Syntax:
${//d:article/d:info/d:<element>/d:<child element>}$
Diese Struktur gilt für die Referenzierung der verschiedenen Info-Elemente in einem Publikations-Topic.
-
d:article verweist auf das Artikelelement im Publikations-Topic
-
d:info verweist auf das darin enthaltene Info-Element
-
d:<element> verweist auf ein Info-Element, z. B. d:pubdate
-
d:<child element> verweist auf ein untergeordnetes Element des vorherigen Elements, z. B. ist d:copyright/d:year ein Verweis auf das Jahreselement, welches wiederum dem Urheberrechtselement nachgeordnet ist.
Beispiel:
${//d:article/d:info/d:copyright/d:year}$
Sie können auch Text hinzufügen, z. B. ist es üblich, in dynamische Variablen den Urheberrechtshinweis aufzunehmen. Die dynamische Variable könnte mit Text beginnen, danach könnten Verweise zu den Urheberrechtsjahr- und Rechteinhaber-Elementen folgen.
Copyright © ${//d:article/d:info/d:copyright/d:year}$ ${//d:article/d:info/d:copyright/d:holder}$
Anmerkung
Wenn Sie sich ein Topic im Paligo Editor ansehen, werden Informationen aus dem Publikations-Topic nicht im Paligo Editor angezeigt. Diese werden erst während der Verarbeitung des Topics für die Veröffentlichung hinzugefügt.
-
-
Drücken Sie Speichern.
Wenn Sie die Publikation veröffentlichen, findet Paligo die Elemente, auf die verwiesen wird, und fügt deren Werte in die dynamischen Variablen ein.
Wenn Sie einen Querverweis hinzufügen, können Sie das Dialogfeld „Neuer Querverweis“ verwenden, um zu dem Topic oder den Elementen zu navigieren, zu denen Sie verlinken möchten. Alternativ können Sie die Suchfunktion nutzen.
-
Wählen Sie das Topic oder die Komponente im Content Manager aus, um es/sie im Editor zu öffnen.
-
Positionieren Sie den Cursor an der gewünschten Stelle für den Querverweis.
-
Wählen Sie die Registerkarte Einfügen im Symbolleiste.
-
Wählen Sie Link und dann Querverweis.
-
Navigieren Sie zu dem Topic, mit dem Sie verlinken möchten, oder verwenden Sie das Suchfeld.
-
Klicken Sie auf die Pfeiltaste im Suchfeld, um die Suchfilter anzuzeigen.
-
Mithilfe der Kontrollkästchen können Sie Ihre Suche filtern.
-
Dokument – Wenn Sie das Kästchen aktivieren, sucht Paligo nur in Topics, informaltopics und anderen „Dokumenten“. Wenn Sie das Kästchen deaktivieren, durchsucht Paligo sowohl „Dokumente“ als auch Ordnernamen. Dies ist nützlich, wenn Sie den Namen des Ordners kennen, der den Inhalt enthält, nur nicht den genauen Namen des „Dokuments“.
-
Inhalt – Aktivieren Sie das Kästchen, um im Hauptinhalt Ihrer Topics zu suchen. Deaktivieren Sie es, um den Inhalt aus dem Suchvorgang auszuschließen.
-
Titel – Aktivieren Sie das Kontrollkästchen, um die Titelelemente Ihrer Topics zu durchsuchen. Löschen Sie es, um die Titelelemente aus Ihrer Suche auszuschließen.
-
Dateiname – Aktivieren Sie das Kontrollkästchen, um nach dem Topic-Namen oder Publikations-Namen statt nach deren Titel zu suchen.
-
Automatische Suche aktivieren – Aktivieren Sie das Kontrollkästchen, um die autosearch-Funktion einzuschalten. Sobald Sie mit dem Eintippen in das Suchfeld beginnen, listet Paligo automatisch Übereinstimmungen auf. Deaktivieren Sie das Kontrollkästchen, um diese Funktion zu deaktivieren.
-
Wildcard-Suche – Aktivieren Sie das Kontrollkästchen, um Wildcard-Zeichen wie * bei der Texteingabe im Suchfeld zuzulassen. Wildcard-Zeichen können für jedes beliebige Zeichen stehen. Deaktivieren Sie das Kästchen, wenn Paligo ausschließlich nach übereinstimmenden Zeichen suchen soll.
Verwenden Sie ein Sternchen (*), um ein oder mehrere Zeichen darzustellen, oder verwenden Sie ein Fragezeichen, um ein einzelnes Zeichen darzustellen. Sie können diese Symbole überall in der Suchzeichenfolge verwenden.
Beispielsweise würde bei
automati*
sowohl „Automatisierung“ als auch „Automatik“ angezeigt, und mitautomo?i?e
finden Sie sowohl „Automobil“ als auch „Automotive“.
-
-
Geben Sie den Text, nach dem Sie suchen möchten, in das Feld Suchen ein.
Paligo findet die nächstgelegenen passenden Ergebnisse und Sie können wählen, zu welchem Sie eine Verknüpfung herstellen möchten.
-
Drücken Sie Speichern.
Sie können auch Bilder als Links verwenden. Zum Einfügen dieser Art von Verknüpfung gibt es jedoch keinen Auswahldialog. Fügen Sie daher das Linkziel als Attribut zum Bild selbst hinzu:
-
Wählen Sie das Element
mediaobject
oderinlinemediaobject
aus. -
Fügen Sie ein
xlink:href
-Attribut hinzu. -
Fügen Sie den Zielwert mit folgender Syntax hinzu:
urn:resource:component:31214
.Der erste Teil ist stets gleich und der letzte Teil (die Ziffern) ist die ID des Ziel-Topics.
Tipp
Sie können die ID des Ziel-Topics erhalten, indem Sie die Strukturansicht für dieses Topic öffnen, wo Sie es oben in den Metadaten finden.
Eine andere Möglichkeit, den gesamten Linkwert zu erhalten, besteht darin, zunächst einen regulären Querverweis als „Dummy“ zu erstellen, den Wert von dort zu kopieren und dann den Dummy-Querverweis wieder zu löschen.
Durch Hinzufügen des Attributs xlink:show
lässt sich das Standard-Verknüpfungsverhalten für einzelne Links überschreiben. Folgende Werte können für dieses Attribut ausgewählt werden:
-
Neu – Öffnet den Link in einem neuen Browserfenster. Dies entspricht dem Effekt, der bei der Verwendung von _blank in den Layout-Einstellungen erzielt wird.
-
Ersetzen – Öffnet den Link im selben Browserfenster. Dies ähnelt dem Effekt, der bei der Verwendung von _self in den Layout-Einstellungen erzielt wird.
-
Einbetten – Dieser Wert gibt an, dass die Ressource geladen und im Dokument angezeigt wird, anstatt mit ihr verknüpft zu werden. Dies ähnelt dem Effekt eines HTML-Bild-Tags. Nur für Anpassungen
-
Andere – Dieser Wert zeigt an, dass der Link ein anderes Markup enthält, das das Verhalten des Zielattributs vorgibt. Nur für Anpassungen
-
Keine – Dieser Wert gibt an, dass es keine Vorgabe darüber gibt, wie auf die verknüpfte Ressource verwiesen werden soll. Nur für Anpassungen
Nachfolgend wird beschrieben, wie Sie einen einzelnen Link so ändern können, dass er in einem anderen Browserfenster geöffnet wird.
-
Wählen Sie den Link im Topic aus.
-
Fügen Sie den
xlink:show
im Panel „Elementattribute“ hinzu. -
Wählen Sie new aus dem Menü.
-
Drücken Sie Speichern.
[en] Does your content have plain text URLs that appear as unwanted hyperlinks in your PDF outputs? If yes, it is likely because your PDF reader is converting the text into links automatically.
[en] In most cases, there is an option in the application to turn this functionality on or off. For example, in Adobe Acrobat Reader, there is a setting in Preferences to Create links from URLs that you can enable or disable. It is in the General category.
[en] For details on how to disable automatic conversions of URLs into links, please refer to the official documentation for your PDF reader application.