Skip to main content

HTML importieren (mehrere Dateien)

Wenn Sie über HTML-Inhalte in mehreren Dateien verfügen, können Sie diese möglicherweise mit der Confluence-Importfunktion von Paligo importieren. Ob dies funktioniert, hängt von der Struktur der HTML ab.

Anmerkung

Wählen Sie die Option Confluence (index.html) aus. Wählen Sie nicht die Option HTML-Import aus, da diese nur für den HTML-Import einzelner Dateien gilt.

Wichtig

Paligo kann nur gültige HTML importieren. Wir empfehlen, Ihre HTML mit einem HTML-Validatierungstool eines Drittanbieters wie https://validator.w3.org/ zu testen.

Wenn die HTML ungültig ist, schlägt der Import fehl (Paligo erkennt, dass die Inhalte ungültig sind, und meldet „nichts zu importieren“).

Mehrere HTML-Dateien für den Import vorbereiten

Um mehrere HTML-Dateien gleichzeitig zu importieren, müssen Sie Ihre HTML-Inhalte auf eine bestimmte Weise organisieren. Außerdem müssen Sie eine „index.html“-Datei erstellen oder bearbeiten, so dass sie eine ungeordnete Liste enthält, die als Inhaltsverzeichnis fungieren kann, mit Links zu den verschiedenen HTML-Dateien, die Sie importieren.

Wichtig

[en] When importing HTML, the folder names are case-sensitive.

Anmerkung

Wir empfehlen, Ihre HTML-Datei mit einem HTML-Validator zu testen, z. B. https://www.html-tidy.org. Dies hilft Ihnen dabei, strukturelle Probleme in Ihrer HTML zu identifizieren und gegebenenfalls zu beheben, bevor Sie versuchen, sie zu importieren.

[en] HTML is not a structured format. The import will handle many flavors of HTML, but because of the many proprietary variants there is no guarantee it will work for yours. If you have problems, inquire about the possibilities to tweak the content.

Dieses HTML-Format importiert jeweils nur eine Datei. Um mehrere HTML-Dateien zu importieren, verwenden Sie den „Confluence“-Import.

Wenn es sich nicht um einen tatsächlichen Confluence-Import handelt, muss die „index.html“ manuell so bearbeitet werden, dass sie eine ul class="toc" umfasst, die die zu importierende Publikationsstruktur enthält.

Tipp

[en] To learn about relative references, see www.w3schools.com.

  1. Bereiten Sie Ihre HTML-Inhaltsdateien vor. Stellen Sie sicher, dass sie eine gültige HTML-Struktur aufweisen, z. B.:

    <!DOCTYPE html>
<html>
<head>
    <title>Sample HTML Page</title>
</head>
<body>
    <h1>This is a Heading Level 1</h1>
    <p>This is some introductory text for our sample HTML page.</p>
    
    <h2>Heading Level 2</h2>
    <p>More text can go here to explain things in detail.</p>
    
    <h3>Heading Level 3</h3>
    <ul>
        <li>Item 1</li>
        <li>Item 2</li>
        <li>Item 3</li>
    </ul>
    
    <h3>Heading Level 3</h3>
    <ol>
        <li>First item</li>
        <li>Second item</li>
        <li>Third item</li>
    </ol>
    
    <h2>Another Heading Level 2</h2>
    <p>More text goes here. Below is an image:</p>
    <img src="https://example.com/sample-image.jpg" alt="Sample Image">
    
    <h2>Table Example</h2>
    <table border="1">
        <tr>
            <th>Header 1</th>
            <th>Header 2</th>
            <th>Header 3</th>
        </tr>
        <tr>
            <td>Row 1, Cell 1</td>
            <td>Row 1, Cell 2</td>
            <td>Row 1, Cell 3</td>
        </tr>
        <tr>
            <td>Row 2, Cell 1</td>
            <td>Row 2, Cell 2</td>
            <td>Row 2, Cell 3</td>
        </tr>
    </table>
</body>
</html>

    Tipp

    Denken Sie daran, dass das <title>-Tag in HTML nicht als Hauptüberschrift verwendet wird, sondern nur für den Titel des Dokuments. Verwenden Sie <h1> für die Hauptüberschrift und dann <h2>- und <h3>-Tags niedrigerer Ebenen für Unterüberschriften.

  2. Organisieren Sie Ihre HTML-Inhalte wie folgt:

    • Übergeordneter „Container“-Ordner

      [en] It is important that the "container" folder includes one index file at the root level, with all other HTML pages inside a subfolder.

      • Index.html

      • Bilderordner

        • Bilddateien

      • CSS-Ordner

        • CSS-Dateien

      • Inhaltsordner

        • HTML-Dateien

    Folder structure shown in Mac iOS. There is a parent folder at the top level. Inside that, there is an index.html file, an images folder, a CSS folder, and a Content folder. The folders are expanded to show that they contain images, a css file, and html files for the content.

    [en] Example of a valid structure to import an HTML multi-file.

    Wichtig

    Stellen Sie sicher, dass Ihr Inhaltsordner nur HTML-Dateien enthält. Er darf keine anderen Dateitypen wie .doc, .js oder .css enthalten.

  3. Nun müssen Sie die index.html-Datei bearbeiten. Öffnen Sie die Datei in einem Text- oder Code-Editor und fügen Sie ihr diese Struktur hinzu:

    <!DOCTYPE html><html>
<head>
    <title>Import</title>
</head>
<body>
    <ul class="toc">
        <li><a href="enter relative link path here">Link text</a></li>
        <li><a href="enter relative link path here">Link text</a></li>
        <li><a href="enter relative link path here">Link text</a></li>
        <li><a href="enter relative link path here">Link text</a></li>
        <li><a href="enter relative link path here">Link text</a></li>
    </ul>
</body>
</html>

    Wo:

    • doctype, html, head, title und body bilden die für alle HTML-Dateien verwendete Grundstruktur.

    • ul definiert den Beginn einer ungeordneten Liste (Aufzählungsliste) und muss den Klassennamen „toc“ aufweisen. Diese Klasse ist wichtig für den Importprozess und ohne sie funktioniert der Import nicht korrekt.

    • li definiert einen Listenpunkt.

    • href definiert eine Verknüpfung. Diese index.html-Datei benötigt für jede html-Seite, die Sie in Paligo importieren möchten, ein Listenelement und einen Link. Bei dem Link muss es sich um eine relative Verknüpfung zu einer html-Datei handeln, die im „Inhaltsordner“ innerhalb des „Container“-Ordners gespeichert ist.

    Wichtig

    Beachten Sie beim Hinzufügen eines Links, dass bei den Ordnernamen auf Groß- und Kleinschreibung zu achten ist.

  4. Wenn Sie die Links hinzugefügt haben, speichern Sie die index.html-Datei.

  5. Erstellen Sie anschließend mit dem Betriebssystem Ihres Computers oder einer Anwendung eines Drittanbieters eine ZIP-Datei des „Container“-Ordners .

    Tipp

    Informationen zum Komprimieren von Dateien finden Sie in der Dokumentation des Betriebssystems:

  6. Importassistenten verwenden Sie können den, um die ZIP-Datei zu importieren. Wählen Sie das Confluence-Format aus, um mehrere Dateien importieren zu können.

Fehlerbehebung bei HTML-Importen

Wenn Ihr HTML-Import nicht funktioniert, empfehlen wir Ihnen:

  • Ihre HTML-Inhalte zu validieren. Paligo importiert nur korrekt formatierte HTML-Inhalte.

    Es gibt viele HTML-Validierungstools, die Sie verwenden können, z. B. https://www.html-tidy.org.

  • Stellen Sie sicher, dass Sie die Inhalte wie beschrieben organisiert haben. Der Import ist nur dann erfolgreich, wenn die Dateien und Ordner in der ZIP-Datei, die Sie importieren, korrekt angeordnet sind.

  • Prüfen Sie, ob Ihre HTML-Dateien relative Verweise auf Bilder und CSS verwenden.

Anmerkung

Wenn Sie diese Probleme behoben haben und der Import weiterhin fehlschlägt, wenden Sie sich an den Kundensupport.