FAQ de

English · 简体中文 · 繁體中文 · Español · العربية · Français · Português (Brasil) · Deutsch · हिन्दी · 日本語 · 한국어 · Русский · Bahasa Indonesia · Türkçe · Italiano · Tiếng Việt

docxi-FAQ: Word-Dokumente in Ruby und Rails

Kurze Antworten auf die häufigsten Fragen. Jede Antwort verlinkt auf eine ausführlichere Erklärung.

Muss Microsoft Word oder LibreOffice installiert sein? Nein. docxi schreibt das XML und das Zip-Archiv selbst.

Braucht docxi Rails? Nein. Es funktioniert in jedem Ruby-Programm. Die Tests laufen außerdem mit geladenem Rails 5.2 bis 8.1. Siehe Integrationen.

Wie erzeuge ich ein Word-Dokument in Ruby on Rails? Bauen Sie es in einem Controller oder einem Hintergrundjob und senden Sie word.render.string mit send_data. Siehe Integrationen.

Welche Ruby- und Rails-Versionen werden unterstützt? Ruby 2.5 und neuer. Rails ist optional, und die CI testet Rails 5.2 bis 8.1. Siehe Installation.

Kann docxi eine vorhandene .docx-Datei bearbeiten oder eine Word-Vorlage ausfüllen? Nein, es erstellt nur neue Dokumente. Für Vorlagen mit Seriendruckfeldern verwenden Sie ein vorlagenbasiertes Gem wie sablon.

Wird das Inhaltsverzeichnis aus den Überschriften erzeugt? Nein. Sie fügen jeden Eintrag und seine Seitenzahl selbst hinzu. Siehe Funktionen.

Kann ich nummerierte Listen oder Überschriftenformatvorlagen verwenden? Nicht in 0.1.0. Absätze können Aufzählungspunkte sein (ul: true), und Überschriften können Sie mit Textoptionen wie size: und bold: formatieren.

Kann ich Seitengröße oder Ausrichtung ändern? Noch nicht. Die Seiten sind US Letter im Hochformat, und nur die Ränder lassen sich ändern. Siehe Konfiguration.

Welche Bildformate funktionieren? PNG. Jedes Bild wird als PNG-Teil gespeichert.

Kann ich ein Bild über eine URL hinzufügen? Ja. add_media akzeptiert http-, https- und ftp-URLs und lädt sie beim Aufruf von render herunter. Übergeben Sie keine URLs von Benutzern, ohne sie zu prüfen. Siehe Sicherheit.

Kann ich das Dokument direkt in eine Datei schreiben? render gibt ein StringIO zurück. Schreiben Sie dessen .string mit File.binwrite("out.docx", word.render.string).

Kann docxi sehr große Dokumente streamen? Nein. Das ganze Dokument wird beim Aufruf von render im Speicher aufgebaut. Siehe Deployment.

Kann ich Absätze von rechts nach links setzen? In 0.1.0 gibt es keine Rechts-nach-links-Optionen. Text wird so geschrieben, wie Sie ihn übergeben.

Wo sind die bekannten Probleme aufgelistet? In der Roadmap und im README-Abschnitt „Limitations and known issues“ (Einschränkungen und bekannte Probleme).

Verwandte Seiten

• Fehlerbehebung
• Funktionen
• Erste Schritte

---

← Wiki-Startseite · README