Créez des fichiers .odt
, .ods
et .odp
avec Ruby ! Pour savoir ce qu'est ODF, veuillez consulter la page de spécifications.
**Remarque : ** Cette gemme est toujours en cours et l'API peut changer même lors d'une mise à jour de version mineure !
Ajoutez cette ligne au Gemfile de votre application :
gem 'odf'
Et puis exécutez :
$ bundle
Ou installez-le vous-même en tant que :
$ gem install odf
Cette gemme propose 3 classes principales pour chaque type de document. Odf::Document::Text
, Odf::Document::Spreadsheet
et Odf::Document::Presentation
. Vous pouvez instancier n'importe lequel d'entre eux comme ceci :
document = Odf :: Document :: Text . new
Après avoir créé le document, vous pouvez y ajouter des éléments. Ici, nous ajoutons un paragraphe à notre document :
document = Odf :: Document :: Text . new
document . add_paragraph ( 'Tülaay, ne olursun geri dön.' )
Pour les éléments disponibles que vous pouvez ajouter à votre document, veuillez consulter le répertoire lib/element
.
Vous pouvez également ajouter des méta-informations à votre document comme ceci :
document = Odf :: Document :: Text . new
document . creator = 'Twentify'
Vous pouvez soit sérialiser votre document directement dans le système de fichiers comme suit :
document = Odf :: Document :: Text . new
document . serialize ( 'path_to_serialize' )
ou faites fonctionner un flux de sortie comme suit :
document = Odf :: Document :: Text . new
document . to_blob
Après avoir extrait le dépôt, exécutez bin/setup
pour installer les dépendances. Ensuite, exécutez rake spec
pour exécuter les tests. Vous pouvez également exécuter bin/console
pour une invite interactive qui vous permettra d'expérimenter.
Pour installer cette gemme sur votre machine locale, exécutez bundle exec rake install
. Pour publier une nouvelle version, mettez à jour le numéro de version dans version.rb
, puis exécutez bundle exec rake release
, qui créera une balise git pour la version, poussera les commits et les balises git, et poussera le fichier .gem
vers rubygems.org.
Les rapports de bogues et les demandes d'extraction sont les bienvenus sur GitHub à l'adresse https://github.com/meinac/odf.
La gemme est disponible en open source selon les termes de la licence MIT.