Skip to main content

Code aus einer externen Quelle einbetten

Sie können die Inhalte Ihrer Hilfe so einstellen, dass stets die neuesten Codebeispiele aus einem Datenspeicher wie GitHub oder BitBucket verwendet werden sollen. Anschließend kann Ihre HTML5-Hilfe Codebeispiele auch ohne erneute Veröffentlichung automatisch aktualisieren.

Anmerkung

Die Codebeispiele müssen in einer „https“-URL enthalten sein.

Tipp

Zum Einbetten von Swagger/Open API-Code siehe Swagger OpenAPI einbetten.

[en] Use dynamic code snippets to have your HTML5 output to use "live" code snippets from a repository.

  1. Wählen Sie im oberen Menü Layout aus.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo zeigt eine Liste von Layouts an. Die Liste ist leer, wenn keine benutzerdefinierten Layouts in Ihrer Paligo-Instanz vorhanden sind.

  2. 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.

  3. Wählen Sie auf der Seitenleiste Klassen und Attribute aus.

    Classes_and_Attributes.png

  4. Wählen Sie Aktivieren für Ausgabe von role-Attributen als Klassennamen.

    Layout. Output role attribute as class names setting. It is set to Enable.

  5. Drücken Sie Speichern.

  6. Wählen Sie das Topic oder die Komponente im Content Manager aus, um es/sie im Editor zu öffnen.

    Content Manager in Paligo. It shows the Documents section contains an Acme 100 Topics folder. Inside the folder there is a publication and many topics, including "Connect to Network (100).

    Alternativ können Sie Topics erstellen und dieses bearbeiten.

  7. Wählen Sie die Stelle aus, an der der Code erscheinen soll.

  8. Drücken Sie Alt + Enter ⏎ (Windows) oder Command ⌘ + Enter ⏎ (Mac), um den Kontextmenü „Elemente“ anzuzeigen.

    Element context menu shows a search field and a list of elements that are valid at the current position.

  9. Fügen Sie ein Codeblockelement hinzu, entweder programlisting oder screen.

  10. Wählen Sie das programlisting- oder screen-Element im Topic aus.

    Tipp

    Mit dem Kürzel Alt, können Sie ein programlisting-Element mit diesen Attributen hinzufügen. Anschließend fügen Sie nur noch den URL-Wert hinzu.

  11. Diese Attribute und Werte werden im Panel „Elementattribute“ hinzugefügt:

    • das Attribut role mit dem Wert embedcode

    • das Attribut xlink:href mit der URL zum Codefragment im Datenspeicher.

  12. Optional: Falls Sie Fallback-Code für andere Ausgabeformate wünschen oder benötigen, fügen Sie das Codefragment auch dem programlisting- bzw. screen-Element hinzu.

  13. Drücken Sie Speichern. Save icon.

Im veröffentlichten Dokument wird der betreffende Code aus dem Datenspeicher abgerufen und automatisch aktualisiert, sobald er sich ändert.

Anmerkung

Wenn Sie auch in anderen Ausgabeformaten wie PDF veröffentlichen, wird der eingebettete Code zum Zeitpunkt der Veröffentlichung nach wie vor dynamisch abgerufen. Sollten Sie hingegen die Codebeispiele in Ihrem Datenspeicher ändern, werden Sie die PDF-Ausgabe erneut veröffentlichen müssen, damit Paligo die aktuellen Änderungen abrufen kann.