Erstellen Sie .odt
, .ods
und .odp
-Dateien mit Ruby! Weitere Informationen zu ODF finden Sie auf der Spezifikationsseite.
**Hinweis: ** Dieses Juwel befindet sich noch in der Entwicklung und die API kann sich auch bei kleineren Versionsaktualisierungen ändern!
Fügen Sie diese Zeile zur Gemfile Ihrer Anwendung hinzu:
gem 'odf'
Und dann ausführen:
$ bundle
Oder installieren Sie es selbst als:
$ gem install odf
Dieses Gem bietet 3 Hauptklassen für jeden Dokumenttyp. Odf::Document::Text
, Odf::Document::Spreadsheet
und Odf::Document::Presentation
. Sie können jede davon wie folgt instanziieren:
document = Odf :: Document :: Text . new
Nachdem Sie das Dokument erstellt haben, können Sie ihm Elemente hinzufügen. Hier fügen wir unserem Dokument einen Absatz hinzu:
document = Odf :: Document :: Text . new
document . add_paragraph ( 'Tülaay, ne olursun geri dön.' )
Die verfügbaren Elemente, die Sie Ihrem Dokument hinzufügen können, finden Sie im Verzeichnis lib/element
.
Sie können Ihrem Dokument auch Metainformationen hinzufügen, etwa so:
document = Odf :: Document :: Text . new
document . creator = 'Twentify'
Sie können Ihr Dokument entweder wie folgt direkt in das Dateisystem serialisieren:
document = Odf :: Document :: Text . new
document . serialize ( 'path_to_serialize' )
oder lassen Sie einen Ausgabestream wie folgt damit arbeiten:
document = Odf :: Document :: Text . new
document . to_blob
Führen Sie nach dem Auschecken des Repos bin/setup
aus, um Abhängigkeiten zu installieren. Führen Sie dann rake spec
aus, um die Tests auszuführen. Sie können auch bin/console
ausführen, um eine interaktive Eingabeaufforderung zu erhalten, mit der Sie experimentieren können.
Um dieses Juwel auf Ihrem lokalen Computer zu installieren, führen Sie bundle exec rake install
aus. Um eine neue Version zu veröffentlichen, aktualisieren Sie die Versionsnummer in version.rb
und führen Sie dann bundle exec rake release
aus. Dadurch wird ein Git-Tag für die Version erstellt, Git-Commits und -Tags gepusht und die .gem
Datei an rubygems.org gepusht.
Fehlerberichte und Pull-Requests sind auf GitHub unter https://github.com/meinac/odf willkommen.
Das Juwel ist als Open Source unter den Bedingungen der MIT-Lizenz verfügbar.