Product Logo

Dokument importieren

Mit dem Live-Editor wandelst du ein Textdokument im OpenDocument-Format (.odt) in Seiten deiner Webseite um. Aus den Überschriften des Dokuments entstehen die Seiten und die Navigation.

Voraussetzungen

  • Der Live-Editor ist eingerichtet (siehe Live-Editor einrichten)
  • Der Editor kennt die URL eines easyWebsite-Converters (siehe Converter einbinden)
  • Du darfst auf den gewählten Branch schreiben
  • Dein Dokument liegt als .odt-Datei vor. Eine Word-Datei speicherst du vorher als .odt, zum Beispiel in LibreOffice.

Converter einbinden

Der Editor wandelt das Dokument nicht selbst um. Er lädt es zum easyWebsite-Converter hoch und bekommt die fertigen Seiten zurück. Ohne Converter-URL zeigt der Editor keinen Import an.

Im Developer Mode übergibst du die URL in pages/preview.tsx an EditorShell:

Baust du mit der CLI, gibst du die URL mit --converter-url an (siehe CLI). Im Easy Mode gibt es dafür noch keinen Parameter.

Der Browser spricht den Converter direkt an. Der Converter muss deshalb CORS-Header für die Adresse deiner Webseite senden.

Dokument importieren

  1. Öffne den Editor unter /preview/ und melde dich an
  2. Wähle den Branch, in den die Seiten sollen
  3. Klicke in der Seitenleiste über dem Dateibaum auf Import document. In einem Projekt ohne Seiten findest du den Button auch auf dem Startbildschirm
  4. Ziehe die .odt-Datei in das Feld oder wähle sie aus
  5. Passe bei Bedarf die Conversion options an (siehe Optionen)
  6. Klicke auf Upload and convert

Der Editor legt einen neuen Ordner an, zum Beispiel converted-ab12, und öffnet dessen Startseite. In der Navigation erscheint der Ordner unter dem Dateinamen des Dokuments.

Die neuen Seiten sind noch nicht gespeichert. Prüfe sie und klicke dann auf Save. Mit Discard verwirfst du sie wieder, zusammen mit allen anderen offenen Änderungen.

Optionen

Die Optionen findest du im Dialog unter Conversion options. Das Info-Symbol neben jeder Auswahl zeigt eine Kurzbeschreibung.

Split into pages at

  • Jede Überschrift bis zu dieser Ebene beginnt eine eigene Seite. Standard ist Ebene 2.
  • Hat eine Seite Unterseiten, wird sie ein Ordner.
  • Tiefere Überschriften bleiben auf der Seite.

Heading numbers

  • Number and title (Standard): Nummer und Titel, zum Beispiel „1.3.1 Datensicherung“
  • Title only: nur der Titel
  • Number only: nur die Nummer
  • As in the document: Die Überschriften bleiben genau so, wie sie im Dokument stehen

Die Nummern ergeben sich aus den Ebenen der Überschriften. Steht schon eine Nummer im Text der Überschrift, entfernt der Import sie vorher. So erscheint sie nicht doppelt.

Show numbers in

  • Navigation and content (Standard): in der Navigation und auf der Seite
  • Navigation only: nur in der Navigation
  • Content only: nur in der Überschrift auf der Seite

Die Option wirkt nur mit Number and title und Number only.

Remove title page

  • Entfernt alles vor der ersten Überschrift der Ebene 1, auch Überschriften.
  • Hat das Dokument keine Überschrift der Ebene 1, ändert sich nichts.
  • Standard ist aus.

Fix heading levels

  • Die erste Überschrift wird Ebene 1, und übersprungene Ebenen werden geschlossen. Aus Ebene 2 gefolgt von Ebene 4 wird zum Beispiel Ebene 1 gefolgt von Ebene 2.
  • Die Reihenfolge und die Verschachtelung bleiben gleich.
  • Standard ist aus.

Sind beide Optionen an, korrigiert der Import zuerst die Ebenen und entfernt danach die Titelseite.

Tipps

  • Die Nummern beginnen mit 0, zum Beispiel „0.1“: Dein Dokument beginnt mit einer Überschrift der Ebene 2. Schalte Fix heading levels ein.
  • Zu viele kleine Seiten: Wähle bei Split into pages at eine kleinere Ebene.
  • Eine Seite ist sehr lang: Wähle eine größere Ebene.

Grenzen

  • Pro Import geht genau eine .odt-Datei.
  • Text vor der ersten Überschrift, die eine Seite beginnt, übernimmt der Import nicht.
  • Der Import legt immer einen neuen Ordner auf der obersten Ebene an. Einen Zielordner kannst du noch nicht wählen.
  • Manche importierten Seiten öffnet der Editor nur als Rohtext. Ursache sind <br> und leere Kommentare <!-- --> in der Seite. Ersetze <br> durch <br /> und lösche die Zeilen mit <!-- -->. Danach öffnet sich die Seite wieder im visuellen Editor.

Nächste Schritte