odf

ODF (открытый формат документа)

Создавайте файлы .odt , .ods и .odp с помощью Ruby! Для получения информации о том, что такое ODF, посетите страницу спецификаций.

**Примечание: ** Этот драгоценный камень все еще находится в разработке, и API может измениться даже при обновлении незначительной версии!

Установка

Добавьте эту строку в Gemfile вашего приложения:

 gem 'odf'

И затем выполните:

 $ bundle

Или установите его самостоятельно как:

 $ gem install odf

Использование

Этот драгоценный камень предоставляет 3 основных класса для каждого типа документа. Odf::Document::Text , Odf::Document::Spreadsheet и Odf::Document::Presentation . Вы можете создать экземпляр любого из них следующим образом:

 document = Odf :: Document :: Text . new

После создания документа в него можно добавлять элементы. Здесь мы добавляем абзац в наш документ:

 document = Odf :: Document :: Text . new
document . add_paragraph ( 'Tülaay, ne olursun geri dön.' )

Доступные элементы, которые вы можете добавить в свой документ, смотрите в каталоге lib/element .

Вы также можете добавить метаинформацию в свой документ следующим образом:

 document = Odf :: Document :: Text . new
document . creator = 'Twentify'

Сериализация?

Вы можете сериализовать документ непосредственно в файловую систему следующим образом:

 document = Odf :: Document :: Text . new
document . serialize ( 'path_to_serialize' )

или заставить выходной поток работать с ним следующим образом:

 document = Odf :: Document :: Text . new
document . to_blob 

Разработка

После проверки репозитория запустите bin/setup , чтобы установить зависимости. Затем запустите rake spec для запуска тестов. Вы также можете запустить bin/console для получения интерактивной подсказки, которая позволит вам поэкспериментировать.

Чтобы установить этот драгоценный камень на свой локальный компьютер, запустите bundle exec rake install . Чтобы выпустить новую версию, обновите номер версии в version.rb , а затем запустите bundle exec rake release , который создаст тег git для этой версии, отправит git коммиты и теги и отправит файл .gem на сайт Rubygems.org.

Содействие

Отчеты об ошибках и запросы на включение приветствуются на GitHub по адресу https://github.com/meinac/odf.

Лицензия

Гем доступен с открытым исходным кодом в соответствии с условиями лицензии MIT.