Skip to content

Configuration de

Hammad Maqbool edited this page Oct 29, 2026 · 1 revision

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

docxi konfigurieren: Seitenränder, Seiteneinrichtung und Einheiten

docxi hat keine Konfigurationsdatei, keine Umgebungsvariablen und keine globalen Einstellungen. Alles wird pro Dokument oder pro Element festgelegt. Diese Seite beschreibt die Einstellungen auf Dokumentebene und die Einheiten, die die Optionen verwenden. Die Optionen der einzelnen Elemente stehen unter Funktionen.

Seitenränder

Die Seitenränder werden beim Erstellen des Dokuments übergeben:

require "docxi"

# Alle Werte in Zwanzigstelpunkt (1440 = 1 Zoll).
word = Docxi::Document.new(top: 1440, right: 1080, bottom: 1440, left: 1080, header: 720, footer: 720)
word.document.p { |p| p.text "One-inch top and bottom margins" }

File.binwrite("margins.docx", word.render.string)
Option Standard Bedeutung
top 720 (0,5 Zoll) Oberer Rand
right 1440 (1 Zoll) Rechter Rand
bottom 720 (0,5 Zoll) Unterer Rand
left 1440 (1 Zoll) Linker Rand
header 190 Abstand von der oberen Seitenkante zur Kopfzeile
footer 200 Abstand von der unteren Seitenkante zur Fußzeile

Der übergebene Hash ersetzt die Standardwerte, setzen Sie top, right, bottom und left also gemeinsam. Jeder dieser vier Werte, den Sie weglassen, wird leer geschrieben. header und footer fallen auf 190 und 200 zurück, wenn sie fehlen oder leer sind.

Seitengröße und Ausrichtung

Die Seiten haben das Format US Letter im Hochformat: 12240 × 15840 Zwanzigstelpunkt, also 8,5 × 11 Zoll. Größe und Ausrichtung lassen sich in 0.1.0 nicht ändern.

Erste Seite

docxi aktiviert immer die Word-Einstellung „Erste Seite anders“. Kopf- und Fußzeilen, die mit add_header und add_footer hinzugefügt werden, gelten ab Seite 2. Seite 1 verwendet add_first_header und add_first_footer, setzen Sie diese also ebenfalls, wenn die erste Seite eine Kopf- oder Fußzeile braucht. Siehe Funktionen.

Was jedes Dokument enthält

  • Die Standardschrift ist Arial, 12 pt.
  • Definierte Formatvorlagen: Normal, DefaultParagraphFont, TableNormal, TableCustom und NoList.
  • Aufzählungspunkte (ul: true) verwenden einen Gedankenstrich als Aufzählungszeichen.
  • Die Dokumenteigenschaften nennen als Anwendung „Docxi Ruby Gem“ und speichern den Zeitpunkt, zu dem das Dokument gerendert wurde.

Einheiten

Option Einheit
Text-size: Punkt (docxi verdoppelt den Wert zu den halben Punkten von Word)
Seitenränder, Absatz-left: und right:, Tabellen-iwidth:, Zeilen-height: Zwanzigstelpunkt (1440 pro Zoll)
Größen von Zellen-borders: Achtelpunkt
columns_width: und Zellen-width: Werden mit 14.92 multipliziert, um Zwanzigstelpunkt zu erhalten, ungefähr Pixel bei 96 dpi
style: von Inline-Bildern CSS-Längen wie "120pt"
pH: und pV: von positionierten Bildern EMU (914400 pro Zoll)
Text- und Füllfarben Hex ohne #, zum Beispiel "8B0000"
fill_color: von Bildern VML-Farbe mit #, zum Beispiel "#00FF00"

Verwandte Seiten


← Wiki-Startseite · README

Clone this wiki locally