Project

docxtor2

0.01
Repository is archived
No commit activity in last 3 years
No release in over 3 years
Ruby docx generator, provides simple DSL for building word documents
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.3
~> 1.4.0
>= 0
>= 0
>= 0

Runtime

= 0.9.9
 Project Readme

docxtor

Build Status Coverage Status Dependency Status Gem Version

Summary

Ruby docx generator. Docxtor is built to work with Ruby 1.8 as well as 1.9

Features

  • Paragraphs and headings markup.
  • Bold, underline & italic font styles.
  • Document table of contents.
  • Document headers & footers, page numbers.

More to come, stay tuned!

Installation

Add this line to your application's Gemfile:

gem 'docxtor'

And then execute:

$ bundle

Or install it yourself as:

$ gem install 'docxtor'

Usage

Here's the taste of what Docxtor's "markup language" may look like.

package = Docxtor.generate do
  table_of_contents "Contents"
  h 1, "heading1"

  p "text1", :b => true do
    style 'p1'
    spacing :before => 80, :after => 240
    italic; u

    w "text2"
    br
    write "text3"
  end

  h 2 do
    w "heading2"
    line_break
    write "some text"
    br
    write "another text"
  end

  p "content", :style => 'p2', :i => true, :align => 'center'
end

package.save('test.docx')

Entry point

Docxtor.generate do
  ...
end

Paragraphs

The main building block of docx document is a paragraph. There're couple of ways of defining a paragraph.

p "Hi there!", :bold => true

Is the same as

p do
  w "Hi there!"
  b
end

or

p do
  write "Hi there!"
  bold
end

Everything styling-related that is written either inside the block or in options hash will be applied to the whole parapraph.

You can mix and match different ways to define text & options.

p "I'm a first string in this paragraph", :bold => true do
  write "I'm a second one."
  u
  w "And we all will be bold and underlined in the same time!"
end

Headings

Currently not working as expected! Will be fixed soon!

Generally the same as paragraphs, but have additional argument - the level of heading and styled by default.

  h 1, "Chapter 1"
  h 2, "Where our hero goes for an adventure"

Table of Contents

Currently not working as expected! Will be fixed soon!

Inserts the ToC for a document with a caption.

table_of_contents "Table of Contents"

Footers & Headers

You can specify following properties for footers and headers:

  • on which pages footer or header will appear (:odd, :even or only :first);
  • alignment (:center, :left, :right)
  • contents of a footer/header, including special keyword :pagenum which inserts page numbers
footer :pagenum, :align => :center
header "Proudly made by me", :pages => :odd
footer "2013", :pages => :first, :align => :right

Breaks

You can insert page_break or newline inside a paragraph with br.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request